ナビゲーション全体を読み込み中です。

Citrix DaaSモニタリングパッケージは、クラウド上でホストされているCitrix Virtual Apps and Desktops環境の健全性とパフォーマンスを可視化します。

これらのロジックモジュールは、Citrix DaaS REST APIを使用して、Citrix Cloud APIを介して、配信グループ、マシンカタログ、マシン、アプリケーション、セッション、ライセンス、ゾーン、およびハイパーバイザーのメトリックを収集します。

Citrix DaaSデータは、Citrixクラウドサービスプリンシパルを使用したOAuth 2.0クライアント認証によって収集されます。

ベンダーAPIの詳細については、以下を参照してください。 Citrix DaaS REST APIについて (NAIST) と Citrix Cloud API を使い始めましょう Citrix社より。

2026年4月現在、LogicMonitorのCitrix DaaSパッケージは、Citrix Cloud DaaS REST APIを通じて利用可能なCitrix DaaS環境と互換性があります。

Citrix DaaS監視の要件

Citrix DaaS Monitoringを使用するには、以下のものが必要です。

  • コレクターからHTTPSアクセスで送信 api.cloud.com
  • その LogicMonitor_Collector_Snippets データソースがポータルにインポートされました。
  • Citrix DaaSサイト、デリバリーグループ、マシンカタログ、マシン、アプリケーション、セッション、ゾーン、ライセンス、ヘルス、ハイパーバイザーデータへの読み取りアクセス権を持つCitrix Cloudサービスプリンシパル
  • API アクセス用に構成された OAuth 2.0 クライアント資格情報
    詳細については、を参照してください。 Citrix DaaS統合 Citrix社より。

Citrix DaaSリソースを監視対象に追加する

以下のいずれかの方法を使用して、Citrix DaaSリソースを監視対象に追加できます。

  • 拡張スクリプト NetScan (推奨)
  • 手動でリソースを追加する

NetScan の詳細については、次を参照してください。 NetScan の概要。

警告: ライセンス超過を避けるため、NetScanを実行する前にLogicMonitorのライセンスが十分にあることを確認してください。また、NetScanのフィルタをテストして、監視対象にしたくないCitrix DaaSリソースが誤って追加されていないことを確認してください。

拡張スクリプトNetScanを使用してCitrix DaaSリソースを追加する

  1. LogicMonitorで、次の場所に移動します モジュール > 応募者と Citrix DaaSモジュールパッケージを探してインストールします。
  2. MFAデバイスに移動する 資料 > 追加 > 高度なネットスキャン. 
  3. NetScanの名前を入力してください(例:Citrix Daas Resources)。 
  4. NetScan を実行するコレクタを選択します。 
  5. 「拡張スクリプトNetScan」を選択します。 方法 ドロップダウンメニュー。 
  6. 拡張スクリプトセクションで、 デバイスの資格情報 > このスキャンにはカスタム資格情報を使用します。 
  7. NetScanにCitrix DaaSの認証情報を提供し、リソースの構成方法を制御するために、以下のプロパティを追加してください。
    プロパティ 詳細説明 必須?
    citrix.daas.customer.idCitrix Cloudのお客様IDはい
    citrix.daas.client.idCitrix CloudサービスのプリンシパルクライアントIDはい
    citrix.daas.client.secret.passCitrix Cloudサービスのプリンシパルクライアントシークレットはい
    citrix.daas.api.urlAPIベースURL、デフォルトは https://api.cloud.com/cvad/manageいいえ
    citrix.daas.oauth.urlOAuthエンドポイントのオーバーライドいいえ
    citrix.daas.group.name検出されたリソースのリソースグループ、デフォルトは Citrix DaaSいいえ
    citrix.daas.onboard.credentials検出されたリソースに認証情報を追加します。デフォルトは trueいいえ
  8. フィルタ このセクションでは、以下のフィルタプロパティを使用して、特定のリソースを検出対象から除外します。これらのフィルタは、Active Discoveryフィルタと同じように動作します。
    リソースレベルのプロパティは自動的に検出され、フィルタリングすることができます。
    利用可能なフィルタ操作には以下が含まれます 等しい、等しくない、より大きい、等しい、より小さい、等しくない、含む、含まない、存在する、存在しない、正規表現一致, RegexNotMatch.
    プロパティ値
    citrix.daas.hypervisor.idハイパーバイザー接続ID
    citrix.daas.hypervisor.uidハイパーバイザー接続UID
    citrix.daas.hypervisor.nameハイパーバイザー接続名
    citrix.daas.hypervisor.address推奨されるハイパーバイザーホスト名またはアドレス
    citrix.daas.hypervisor.zoneハイパーバイザーゾーン

推奨事項: まず、監視したいリソースのごく一部だけを検出する特定のフィルターを作成します。その後、必要に応じてフィルターの操作や値を段階的に変更し、追加のリソースを取り込んでいきます。

警告: フィルタを設定しない場合、NetScan は検出されたすべての Citrix DaaS リソースを個別の LogicMonitor リソースとして追加しようとします。

  1. 選択 Groovyスクリプトを埋め込む そして、提供されたスクリプトを埋め込んでください。

警告: スクリプトを編集しないでください。編集された拡張スクリプト NetScan はサポートされていません。 LogicMonitor が提供するスクリプトを編集した場合、問題が発生した場合、LogicMonitor サポートはサポートされているスクリプトで編集内容を上書きするよう要求する場合があります。

/*******************************************************************************
 * © 2007-2026 - LogicMonitor, Inc. All rights reserved.
 ******************************************************************************/

import com.santaba.agent.groovy.utils.GroovyScriptHelper as GSH
import com.logicmonitor.mod.Snippets

def debug = false

// Set props object based on whether or not we are running inside a netscan or debug console
def props
try {
    hostProps.get("system.hostname")
    props = hostProps
    debug = true  // set debug to true so that we can ensure we do not print sensitive properties
}
catch (MissingPropertyException) {
    props = netscanProps
}

def customerId         = props.get("citrix.daas.customer.id")
def clientId           = props.get("citrix.daas.client.id")
def clientSecret       = props.get("citrix.daas.client.secret.pass")
def rootFolder         = props.get("citrix.daas.group.name", props.get("citrix.daas.folder.name", "Citrix DaaS"))
def onboardCreds       = props.get("citrix.daas.onboard.credentials", "true").toBoolean()
def includeHypervisors = props.get("discover.hypervisors", props.get("discover.hypervisor", "true")).toBoolean()

def loader  = GSH.getInstance(GroovySystem.version).getScript("Snippets", Snippets.getLoader()).withBinding(getBinding())
def emit    = loader.load("lm.emit", "1")
def lmDebug = loader.load("lm.debug", "1").debugSnippetFactory(out, debug, false, "${customerId}::citrix-daas-api")
def cache   = loader.load("lm.cache", "0").cacheSnippetFactory(lmDebug, "${customerId}::citrix-daas-api")
def http    = loader.load("proto.http", "0").httpSnippetFactory(props)
def api     = loader.load("citrix.daas", "0").create(props, lmDebug, cache, http)

def resources = []

def sites = api.getData("cvad/manage/me")?.Customers?.find { it?.Id == customerId }?.Sites
sites?.each { site ->
    def siteName = site.Name?.trim() ?: site.Id
    if (!site.Id || !siteName) {
        lmDebug.LMDebugPrint("Skipping Citrix DaaS site with missing ID or name: ${site}")
        return
    }

    def siteHostname = siteName.toLowerCase()
                               .replaceAll(/[^a-z0-9.-]+/, "-")
                               .replaceAll(/\.+/, ".")
                               .replaceAll(/^[.-]+|[.-]+$/, "")
                               .replaceAll(/(\.invalid)?$/, ".invalid")

    def sitePropsToEmit = ["citrix.daas.customer.id"  : customerId,
                           "citrix.daas.site.id"      : site.Id,
                           "citrix.daas.site.name"    : emit.sanitizePropertyValue(siteName),
                           "citrix.daas.resource.type": "site",
                           "system.categories"        : "CitrixDaaSSite,NoPing"]

    if (onboardCreds) {
        sitePropsToEmit["citrix.daas.client.id"] = clientId
        sitePropsToEmit["citrix.daas.client.secret.pass"] = clientSecret
    }

    resources.add(["hostname"   : siteHostname,
                   "displayname": siteName,
                   "hostProps"  : sitePropsToEmit,
                   "groupName"  : [rootFolder]])

    if (!includeHypervisors)
        return

    def hypervisors = api.getAllPages("cvad/manage/Hypervisors", site.Id)
    hypervisors?.each { hypervisor ->
        def hypervisorName = hypervisor.Name ?: hypervisor.Id
        if (!hypervisor.Id || !hypervisorName) {
            lmDebug.LMDebugPrint("Skipping Citrix DaaS hypervisor with missing ID or name: ${hypervisor}")
            return
        }

        def hypervisorAddress = hypervisor.Addresses?.find { it }?.trim()
        def hypervisorHostname = hypervisorAddress?.replaceFirst(/^[a-zA-Z][a-zA-Z0-9+.-]*:\/\//, "")
                                                  ?.tokenize("/:")?.find()

        if (!hypervisorHostname) {
            def syntheticId = hypervisor.Id.toLowerCase()
                                           .replaceAll(/[^a-z0-9.-]+/, "-")
                                           .replaceAll(/^-|-$/, "")
            hypervisorHostname = "citrix-daas-hypervisor-${syntheticId}.local"
        }

        def hypervisorProps = ["citrix.daas.resource.type"              : "hypervisor",
                               "citrix.daas.customer.id"                : customerId,
                               "citrix.daas.site.id"                    : site.Id,
                               "citrix.daas.site.name"                  : emit.sanitizePropertyValue(siteName),
                               "citrix.daas.hypervisor.id"              : hypervisor.Id,
                               "citrix.daas.hypervisor.uid"             : hypervisor.Uid,
                               "citrix.daas.hypervisor.name"            : emit.sanitizePropertyValue(hypervisorName),
                               "citrix.daas.hypervisor.address"         : hypervisorAddress,
                               "citrix.daas.hypervisor.connection_type" : hypervisor.ConnectionType,
                               "citrix.daas.hypervisor.plugin_id"       : hypervisor.PluginId,
                               "citrix.daas.hypervisor.state"           : hypervisor.State,
                               "citrix.daas.hypervisor.zone"            : emit.sanitizePropertyValue(hypervisor.Zone?.Name),
                               "system.categories"                      : "CitrixDaaSHypervisor"]

        if (onboardCreds) {
            hypervisorProps["citrix.daas.client.id"] = clientId
            hypervisorProps["citrix.daas.client.secret.pass"] = clientSecret
        }

        resources.add(["hostname"   : hypervisorHostname,
                       "displayname": hypervisorName,
                       "hostProps"  : hypervisorProps,
                       "groupName"  : ["${rootFolder}/Hypervisors"]])
    }
}

if (!resources)
    throw new Exception("No Citrix DaaS sites with IDs were returned from /me. Verify service principal permissions.")

emit.resource(resources, debug)

return 0
  1. スケジュール セクション、選択 このNetScanをスケジュールに従って実行する。 動的環境の場合、NetScan を XNUMX 時間ごとに実行するようにスケジュールできます。
  2. 選択 Save or 保存して実行

NetScanを実行した後、追加されたリソースの数、またはNetScanがリソースを作成しなかった場合のエラーメッセージについて履歴を確認してください。

Citrix DaaSリソースを手動で追加する

  1. Citrix DaaSリソースグループを作成します。
    詳細については、を参照してください。 リソースグループの追加. 
  2. 次のプロパティを持つネットワークリソースグループを使用して、Citrix DaaSリソースグループにリソースを追加します。
    プロパティ 詳細説明 必須?
    citrix.daas.site.idCitrix DaaSサイトIDはい
  3. リソースまたはリソース グループに次のプロパティを追加するか、設定されていることを確認します。
    お願い: Citrix DaaS監視パッケージは、 addCategory_Citrix_DaaS PropertySource は、検出されたリソースに Citrix DaaS カテゴリとプロパティを割り当てます。サイト リソースは、 CitrixDaaSSite (NAIST) と NoPing カテゴリ。ハイパーバイザー検出が有効になっている場合、ハイパーバイザーリソースにはCitrixDaaSHypervisorカテゴリが割り当てられます。

    プロパティ 詳細説明 必須?
    citrix.daas.customer.idCitrix Cloudのお客様IDはい
    citrix.daas.client.idCitrix CloudサービスのプリンシパルクライアントIDはい
    citrix.daas.client.secret.passCitrix Cloudサービスのプリンシパルクライアントシークレットはい
    citrix.daas.site.idCitrix DaaSサイトIDはい
    citrix.daas.api.urlAPIベースURL。デフォルトは https://api.cloud.com/cvad/manageいいえ
    citrix.daas.oauth.urlOAuthエンドポイントのオーバーライドいいえ
    citrix.daas.onboard.credentials検出されたリソースに認証情報を追加します。デフォルトは trueいいえ

プロパティの設定の詳細については、を参照してください。 リソースとインスタンスのプロパティ.

ロジックモジュールのインポート

Citrix DaaSモニタリングパッケージに含まれるすべてのLogicModuleをLM Exchangeからインポートします。

これらのLogicModuleが既に存在する場合は、最新バージョンに更新されていることを確認してください。インポート後、検出とデータ収集が自動的に開始されます。

注意: その Citrix_DaaS_API キャッシュされたAPIデータを共有するには、データソースと他のCitrix DaaSデータソースが同じコレクター上で実行されている必要があります。

トラブルシューティング

Citrix DaaSモニタリングパッケージの導入または運用時に発生する一般的な問題の診断と解決には、以下の表をご参照ください。

問題解像度
API接続の問題コレクターの接続を確認する api.cloud.com そして、APIエンドポイントへのアクセス可能性を確認してください。
認証失敗Citrix DaaSのプロパティとCitrix Cloudサービスのプリンシパル権限を確認します。
オブザーバーデータ収集に関する問題確保 Citrix_DaaS_API キャッシュを基盤とするデータソースと同じコレクター上で動作します。
リソース分類に関する問題リソースが想定どおりのCitrix DaaSカテゴリを取得していることを確認してください。
キャッシュされたデータの動作キャッシュされた値は、キャッシュエントリの有効期限が切れるまで表示され続けます。
デバッギングCollectorとスクリプトのトラブルシューティングについては、以下を参照してください。 コレクターデバッグ機能.

パッケージ内のLogicModules

LogicMonitorのCitirx DaaS向けパッケージは、以下のLogicModulesで構成されています。完全なカバレッジを実現するには、以下のLogicModulesをプラットフォームにインポートしてください。

表示名タイプ 詳細説明
Citrix DaaS APIデータソースCitrix DaaS REST APIデータ用のオブザーバーモジュール。
Citrix DaaSアプリケーションの使用状況データソースCitrix DaaSで公開されているアプリケーションのセッション使用状況を監視します。
Citrix DaaSアプリケーションデータソースCitrix DaaSアプリケーションの公開状態を監視します。
Citrix DaaSクラウドコネクタデータソースCitrix DaaS Cloud Connectorを使用して、マシンの分布と状態を監視します。
Citrix DaaS接続障害の傾向データソース現在のCitrix DaaS接続と起動失敗のカテゴリを監視します。
Citrix DaaSデリバリーグループデータソースCitrix DaaS配信グループの可用性と健全性を監視します。
Citrix DaaSハイパーバイザーマシンデータソースハイパーバイザー接続リソースによってホストされているCitrix DaaSマシンを監視します。
Citrix DaaSハイパーバイザーの概要データソースCitrix DaaSハイパーバイザー接続リソースの健全性と利用権限の状態を監視します。
Citrix DaaSハイパーバイザーデータソースサイトリソースからCitrix DaaSハイパーバイザーの接続状態とホストされているマシンの数を監視します。
Citrix DaaS マシンカタログデータソースCitrix DaaSマシンカタログの容量と状態を監視します。
Citrix DaaSセッションのパフォーマンスデータソースCitrix DaaSの現在のセッション状態と最近のセッションのパフォーマンス傾向を監視します。
Citrix DaaSサイトの概要データソースCitrix DaaSサイト全体のインベントリと健全性カウントを監視します。
Citrix DaaSゾーンデータソースCitrix DaaSゾーンの健全性とリソース数を監視します。
Citrix_DaaS_TopologyトポロジーソースCitrix DaaSサイト、ハイパーバイザー接続、およびホストマシン間の関係をマッピングします。
addCategory_Citrix_DaaSプロパティソースCitrix DaaSサイトまたはハイパーバイザーのカテゴリを設定し、Citrix DaaSのプロパティを更新します。
addERI_Citrix_DaaSプロパティソースサイトおよびハイパーバイザー接続リソースのCitrix DaaS外部リソースID(ERI)を設定します。

このパッケージの DataSource によって追跡されるさまざまなメトリクスに静的なデータポイントのしきい値を設定する場合、LogicMonitor はテクノロジー所有者のベスト プラクティス KPI 推奨事項に従います。

推奨事項: 必要に応じて、これらの定義済みしきい値を調整して、環境固有のニーズに対応してください。データポイントのしきい値の調整方法の詳細については、「データポイントの静的しきい値」を参照してください。

14日間フルアクセス LogicMonitor プラットフォーム