Grafana の統合
注意:
接触 CAS-PM-Ext@cloud.com Grafana 統合の支援をリクエストしたり、Grafana にデータをエクスポートしたり、フィードバックを提供したりします。
Citrix Analytics for PerformanceをGrafanaと統合するには、 プロムテール エージェント。 この統合により、セッションとインフラストラクチャのデータをCitrix IT環境からGrafanaにエクスポートして関連付けることができます。 また、組織のセキュリティ体制についてより深い洞察を得ることができます。
以下の詳細については、 データエクスポート:
- 統合の利点
- オブザーバビリティプラットフォームに送信される処理済みデータのタイプ
前提条件
-
少なくとも 1 つのデータソースのデータ処理を有効にします。 これは、Citrix Analytics for PerformanceがGrafana統合プロセスを開始するのに役立ちます。
-
次のエンドポイントがネットワークの許可リストに含まれていることを確認します。
Endpoint 米国地域 欧州連合地域 アジア太平洋南部地域 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 Cloud。 あなたはインストールすることができます プロムテール剤 Docker、Helm、apt、または手動で使用することもできます。
Promtailは、通常config.yamlと呼ばれるYAMLファイルで構成されます。 この YAML ファイルには、Promtail サーバーに関する情報、位置が保存される場所、ファイルからログをスクレイピングする方法が含まれています。
次に例を示します プロムテール Citrix Analytics for Performanceからレコードを消費するためのスクレイピング構成:
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:
<!--NeedCopy-->
上記の構成に基づいて、 プロムテール Citrix Analytics ブローカーに接続し、Citrix Analytics for Performanceレコードを消費します。 消費されるKafkaトピックには、セッションレコードとマシンレコードが含まれます。
ザ プロムテール を使用して Session と Machine の詳細を分離します。 イベントタイプ ラベルだけでなく、 サイト名 そして deliveryGroupName (配信グループ名). イベント タイムスタンプ フィールドが解析され、格納されたログの最終的な時間値を上書きします。 ロキ.
上記の構成で参照されている証明書ファイルは、次の手順を使用してダウンロードできます。
- 行きます Citrix Analyticsの > 設定 > データのエクスポート > 安全.
- をクリックします SIEM環境設定 ペインを選択し、 余人 オプション。
-
PEM ファイルをダウンロードし、ホストするシステムに保存します。
プロムテールエージェント。
Grafana ダッシュボードのサンプル
Citrixが提供するサンプルのGrafanaダッシュボードをインポートできます。
- メトリック
- タイムチャート
- セッションとインフラストラクチャのテレメトリのその他の便利な視覚化。
ダッシュボード定義 (JSON ファイル) は、 Citrix Analytics のダウンロード ページ。
ダッシュボード ファイルは、Grafana インスタンス (Grafana クラウドまたはエンタープライズ アカウント) にインポートできます。
ダッシュボードをインポートする前に、 ロキ Grafana のデータ ソース。 ダッシュボードのインポート中に、 ロキ データ ソース。 ダッシュボードをインポートしたら、Grafana でダッシュボードを表示できます。
次に、サンプル ダッシュボードを示します。
