Grafana 集成
注意：
联系 CAS-PM-Ext@cloud.com 以请求有关 Grafana 集成、将数据导出到 Grafana 的帮助或提供反馈。
您可以使用 Promtail 代理将 Citrix Analytics for Performance 与 Grafana 集成。这种集成使您能够将会话和基础架构数据从 Citrix IT 环境导出并关联到 Grafana。此外，还要更深入地了解贵组织的安全状况。
有关以下内容的更多信息，请参阅数据导出：
- 整合的好处
- 发送到您的可观测性平台的已处理数据的类型
必备条件
-
为至少一个数据源启用数据处理。它有助于 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 可观测性平台：
设置数据导出帐户
-
前往“设置”>“数据导出”。
-
在“帐户设置”部分，通过指定用户名和密码来创建帐户。此帐户用于
Promtail配置文件，这是集成所必需的。
-
确保密码满足以下条件：
Promtail 配置
Promtail 是一个将本地日志的内容运送到专用 Grafana Loki 实例或 Grafana 云的代理。您可以使用 Docker、Helm、apt 甚至手动安装 Promtail Agent。
Promtail 是在 YAML 文件中配置的，通常称为 config.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:
<!--NeedCopy-->
根据上述配置，Promtail 连接到 Citrix Analytics 代理并使用 Citrix Analytics for Performance 记录。占用的 Kafka 主题包括会话和计算机记录。
Promtail 使用 eventType 标签将会话和计算机详细信息分开，但也会添加诸如 siteName 和 deliveryGroupName 之类的标签。事件时间戳字段会被解析并覆盖存储在 Loki 中的日志的最终时间值。
您可以使用以下步骤下载前面配置中引用的证书文件：
- 前往 Citrix Analytics > 设置 > 数据导出 > 安全。
- 单击 SIEM 环境设置窗格并选择其他选项。
-
下载 PEM 文件并将其存储在托管
Promtail代理的系统中。
Grafana 控制面板示例
您可以导入 Citrix 提供的示例 Grafana 控制面板，其中包括：
- 指标
- 时间图表
- 会话和基础设施遥测的其他有用可视化效果。
您可以从 Citrix Analytics 下载页面下载控制板定义（JSON 文件）。
您可以将控制面板文件导入到您的 Grafana 实例中，既可以导入到 Grafana 云中，也可以导入到企业帐户。
在导入控制面板之前，请确保您已在 Grafana 中正确配置了 Loki 数据源。在控制板导入期间，系统会提示您选择 Loki 数据源。导入仪表盘后，您可以在 Grafana 上查看仪表盘。
以下是示例控制板：
