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:9094
casnb-eu-0.citrix.com:9094
casnb-aps-0.citrix.com:9094
casnb-1.citrix.com:9094
casnb-eu-1.citrix.com:9094
casnb-aps-1.citrix.com:9094
casnb-2.citrix.com:9094
casnb-eu-2.citrix.com:9094
casnb-aps-2.citrix.com:9094
casnb-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 上查看仪表盘。
以下是示例控制板: