Grafana 集成

Last published : Nov 04, 2026
注意：
请联系 mailto:CAS-PM-Ext@cloud.com 以请求 Grafana 集成、将数据导出到 Grafana 的帮助，或提供反馈。
您可以使用 Promtail 代理将 Citrix Analytics for Performance™ 与 Grafana 集成。此集成使您能够将 Citrix IT 环境中的会话和基础设施数据导出并关联到 Grafana。此外，还可以更深入地了解组织的安全状况。
有关以下内容的更多信息，请参阅数据导出：
  • 集成的优势
  • 发送到您的可观测性平台的数据类型
Related information
数据导出到可观测性平台（预览版）

先决条件

  • 为至少一个数据源开启数据处理。这有助于 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 可观测性平台：
Grafana 架构

设置数据导出帐户

  1. 转到 设置 > 数据导出。
  2. 在“账户设置”部分，通过指定用户名和密码来创建账户。此账户用于 Promtail 配置文件，这是集成所必需的。
    SIEM 数据导出
  3. 确保密码满足以下条件：
    SIEM 密码要求

Promtail 配置

Promtail 是一个代理，它将本地日志的内容发送到私有 Grafana Loki 实例或 Grafana Cloud。您可以使用 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:
根据上述配置，Promtail 连接到 Citrix Analytics 代理并消费 Citrix Analytics for Performance 记录。消费的 Kafka 主题包括会话和机器记录。
Promtail 使用 eventType 标签分离会话和机器详细信息，但也添加了诸如 siteName 和 deliveryGroupName 之类的标签。事件 timestamp 字段被解析并覆盖存储在 Loki 中的日志的最终时间值。
您可以使用以下步骤下载上述配置中引用的证书文件：
  1. 转到“Citrix Analytics”>“设置”>“数据导出”>“安全”。
  2. 单击“SIEM 环境设置”窗格并选择“其他”选项。
  3. 下载 PEM 文件并将其存储在托管 Promtail 代理的系统中。
    下载 PEM

Grafana 仪表板示例

您可以导入 Citrix 提供的 Grafana 仪表板示例，其中包括：
  • 指标
  • 时间图表
  • 会话和基础架构遥测的其他有用可视化.
您可以从 Citrix Analytics 下载 页面下载仪表板定义（JSON 文件）。
您可以将仪表板文件导入到您的 Grafana 实例中，无论是 Grafana 云还是企业帐户。
在导入仪表板之前，请确保您已在 Grafana 中正确配置了您的 Loki 数据源。在导入仪表板期间，系统会提示您选择 Loki 数据源。导入仪表板后，您可以在 Grafana 上查看仪表板。
以下是示例仪表板：
Grafana 架构
Grafana 架构