Citrix DaaSモニタリング
最終更新日:2026年9月21日
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リソースを追加する
- LogicMonitorで、次の場所に移動します モジュール > 応募者と Citrix DaaSモジュールパッケージを探してインストールします。
- MFAデバイスに移動する 資料 > 追加 > 高度なネットスキャン.
- NetScanの名前を入力してください(例:Citrix Daas Resources)。
- NetScan を実行するコレクタを選択します。
- 「拡張スクリプトNetScan」を選択します。 方法 ドロップダウンメニュー。
- 拡張スクリプトセクションで、 デバイスの資格情報 > このスキャンにはカスタム資格情報を使用します。
- 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いいえ - フィルタ このセクションでは、以下のフィルタプロパティを使用して、特定のリソースを検出対象から除外します。これらのフィルタは、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 リソースとして追加しようとします。
- 選択 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- スケジュール セクション、選択 このNetScanをスケジュールに従って実行する。 動的環境の場合、NetScan を XNUMX 時間ごとに実行するようにスケジュールできます。
- 選択 Save or 保存して実行
NetScanを実行した後、追加されたリソースの数、またはNetScanがリソースを作成しなかった場合のエラーメッセージについて履歴を確認してください。
Citrix DaaSリソースを手動で追加する
- Citrix DaaSリソースグループを作成します。
詳細については、を参照してください。 リソースグループの追加. - 次のプロパティを持つネットワークリソースグループを使用して、Citrix DaaSリソースグループにリソースを追加します。
プロパティ 詳細説明 必須? citrix.daas.site.idCitrix DaaSサイトID はい - リソースまたはリソース グループに次のプロパティを追加するか、設定されていることを確認します。お願い: Citrix DaaS監視パッケージは、
addCategory_Citrix_DaaSPropertySource は、検出されたリソースに 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 推奨事項に従います。
推奨事項: 必要に応じて、これらの定義済みしきい値を調整して、環境固有のニーズに対応してください。データポイントのしきい値の調整方法の詳細については、「データポイントの静的しきい値」を参照してください。


