Grafana連携
注:
Grafana連携、Grafanaへのデータエクスポート、またはフィードバックの提供に関するサポートを依頼するには、mailto:CAS-PM-Ext@cloud.comにお問い合わせください。
Promtailエージェントを使用すると、Citrix Analytics for Performance™をGrafanaと統合できます。この統合により、Citrix IT環境からのセッションデータとインフラストラクチャデータをGrafanaにエクスポートして関連付けることができます。また、組織のセキュリティ体制についてより深い洞察を得ることができます。
以下に関する詳細については、「データエクスポート」を参照してください。
-
統合の利点
-
オブザーバビリティプラットフォームに送信される処理済みデータの種類
前提条件
-
少なくとも1つのデータソースでデータ処理をオンにします。これにより、Citrix Analytics for PerformanceはGrafana統合プロセスを開始できます。
-
以下のエンドポイントがネットワークの許可リストに含まれていることを確認してください。
エンドポイント 米国リージョン 欧州連合リージョン アジア太平洋南部リージョン Kafkaブローカー casnb-0.citrix.com:9094casnb-eu-0.citrix.com:9094casnb-aps-0.citrix.com:9094casnb-1.citrix.com:9094casnb-eu-1.citrix.com:9094casnb-aps-1.citrix.com:9094casnb-2.citrix.com:9094casnb-eu-2.citrix.com:9094casnb-aps-2.citrix.com:9094casnb-3.citrix.com:9094
Grafana と連携する
以下のアーキテクチャ図は、Citrix Analytics for Performance から Grafana 可観測性プラットフォームへのデータの流れを説明しています。
Grafana アーキテクチャ(/en-us/citrix-analytics/media/grafana-integration.png)
データエクスポートアカウントのセットアップ
-
設定 > データエクスポート に移動します。
-
「アカウント設定」セクションで、ユーザー名とパスワードを指定してアカウントを作成します。このアカウントは、統合に必要な
Promtail設定ファイルで使用されます。
-
パスワードが次の条件を満たしていることを確認してください。
Promtail設定
Promtailは、ローカルログの内容をプライベートなGrafana LokiインスタンスまたはGrafana Cloudに送信するエージェントです。Promtail Agentは、Docker、Helm、apt、または手動でインストールできます。
Promtailは、通常config.yamlと呼ばれるYAMLファイルで設定されます。このYAMLファイルには、Promtailサーバーに関する情報、位置の保存場所、およびファイルからログをスクレイピングする方法が含まれています。
以下は、Citrix Analytics for Performanceからレコードを消費するための
Promtailスクレイプ設定の例です。
scrape_configs:
- job_name: kafka
kafka:
brokers:
- [Citrix Analytics Kafka broker1]
- [Citrix Analytics Kafka broker2]
...
topics:
- [Citrix Analytics for Performance Kafka topic]
group_id: [Citrix Analytics Kafka group ID]
authentication:
type: sasl
sasl_config:
mechanism: SCRAM-SHA-256
user: [Citrix Analytics Kafka account username]
password: [Citrix Analytics Kafka account password]
ca_file: [Path to the Citrix Analytics certificate file (.pem)]
use_tls: true
insecure_skip_verify: true
labels:
job: kafka_casp
relabel_configs:
- action: replace
source_labels:
- __meta_kafka_topic
target_label: topic
pipeline_stages:
- match:
selector: '{job = "kafka_casp"} |= "sessionKey"'
stages:
- json:
expressions:
eventType: eventType
siteName: siteName
deliveryGroupName: deliveryGroupName
protocol: protocol
timestamp: timestamp
- timestamp:
source: timestamp
format: 2006-01-02T15:04:05Z
- labels:
eventType:
siteName:
deliveryGroupName:
protocol:
- match:
selector: '{job = "kafka_casp"} != "sessionKey"'
stages:
- json:
expressions:
eventType: eventType
siteName: siteName
deliveryGroupName: deliveryGroupName
machineName: machineName
timestamp: timestamp
- timestamp:
source: timestamp
format: 2006-01-02 15:04:05
- labels:
eventType:
siteName:
deliveryGroupName:
machineName:
上記の設定に基づき、
PromtailはCitrix Analyticsブローカーに接続し、Citrix Analytics for Performanceレコードを消費します。消費されたKafkaトピックには、セッションレコードとマシンレコードが含まれます。
Promtailは、eventTypeラベルを使用してセッションとマシンの詳細を分離しますが、siteNameやdeliveryGroupNameのようなラベルも追加します。イベントのタイムスタンプフィールドは解析され、Lokiに保存されているログの最終的な時間値を上書きします。
上記の設定で参照されている証明書ファイルは、次の手順でダウンロードできます。
-
Citrix Analytics > 設定 > データエクスポート > セキュリティに移動します。
-
SIEM環境設定ペインをクリックし、「その他」オプションを選択します。
-
PEMファイルをダウンロードし、
Promtailエージェントをホストするシステムに保存します。
Grafanaダッシュボードのサンプル
Citrixが提供するGrafanaダッシュボードのサンプルをインポートできます。これには以下が含まれます。
-
メトリック
-
タイムチャート
-
セッションおよびインフラストラクチャのテレメトリに関するその他の便利な視覚化。
ダッシュボード定義（JSONファイル）は、Citrix Analyticsダウンロードページからダウンロードできます。
ダッシュボードファイルは、GrafanaクラウドまたはエンタープライズアカウントのいずれかのGrafanaインスタンスにインポートできます。
ダッシュボードをインポートする前に、Grafanaで
Lokiデータソースが適切に構成されていることを確認してください。ダッシュボードのインポート中に、Lokiデータソースを選択するよう求められます。ダッシュボードがインポートされた後、Grafanaでダッシュボードを表示できます。
サンプルダッシュボードは次のとおりです。
