Integración de Grafana

Nota:

Contacte con CAS-PM-Ext@cloud.com para solicitar ayuda para la integración de Grafana, exportar datos a Grafana o enviar comentarios.

Puede integrar Citrix Analytics for Performance con Grafana mediante el agente Promtail. Esta integración le permite exportar los datos de sesión e infraestructura de su entorno de TI de Citrix a Grafana y correlacionarlos. Además, puede obtener información adicional sobre la postura de seguridad de su organización.

Para obtener más información acerca de lo siguiente, consulte Exportación de datos:

• Ventajas de la integración
• El tipo de datos procesados que se envían a su plataforma de Observabilidad

Requisitos previos

• Active el procesamiento de datos para al menos un origen de datos. Ayuda a Citrix Analytics for Performance a iniciar el proceso de integración de Grafana.

• Asegúrese de que el siguiente punto de enlace esté en la lista de permitidos en su red.

  Dispositivo de punto final	Región de los Estados Unidos	Región de la Unión Europea	Región Asia-Pacífico Sur
  Intermediarios de 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

Integrar con Grafana

El siguiente diagrama de arquitectura explica cómo fluyen los datos desde Citrix Analytics for Performance a la plataforma de observabilidad Grafana:

Configurar cuenta de exportación de datos

1. Vaya a Configuración > Exportación de datos.

2. En la sección Configuración de la cuenta, cree una cuenta especificando el nombre de usuario y la contraseña. Esta cuenta se usa en el archivo de configuración Promtail, que es necesario para la integración.

   

3. Asegúrese de que la contraseña cumpla con las siguientes condiciones:

   

Configuración de Promtail

Promtail Es un agente que envía el contenido de los registros locales a una instancia Grafana Loki privada o Grafana Cloud. Puede instalar Promtail Agent mediante Docker, Helm, apt o incluso manualmente.

Promtail se configura en un archivo YAML, normalmente denominado config.yaml. Este archivo YAML contiene información sobre el servidor Promtail, dónde se almacenan las posiciones y cómo extraer los registros de los archivos.

El siguiente es un ejemplo de configuración de extracción de Promtail para consumir registros de 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-->

Según la configuración anterior, Promtail se conecta a los brokers de Citrix Analytics y consume los registros de Citrix Analytics for Performance. El tema consumido de Kafka incluye registros de sesión y máquina.

Promtail Separa los detalles de la sesión y de la máquina mediante la etiqueta eventType, pero también agrega etiquetas como siteName y deliveryGroupName. El campo de marca de hora del evento se analiza y anula el valor de hora final de los registros almacenados en Loki.

Puede descargar el archivo de certificado al que se hace referencia en la configuración anterior siguiendo estos pasos:

1. Vaya a Citrix Analytics > Parámetros > Exportaciones de datos > Seguridad.
2. Haga clic en el panel Configuración del entorno SIEM y seleccione la opción Otros.

3. Descargue el archivo PEM y guárdelo en el sistema que aloja el agente Promtail.

   

Ejemplo de panel de Grafana

Puede importar el panel de Grafana de ejemplo que proporciona Citrix, que incluye:

• Métricas
• Gráficos de tiempo
• Otras visualizaciones útiles de la telemetría de sesión e infraestructura.

Puede descargar las definiciones de los paneles (archivos JSON) desde la página de descargas de Citrix Analytics.

Puede importar los archivos del panel a su instancia de Grafana, ya sea a una nube de Grafana o a una cuenta empresarial.

Antes de importar el panel, asegúrese de haber configurado correctamente su fuente de datos de Loki en Grafana. Durante la importación del panel, se le pedirá que seleccione la fuente de datos de Loki. Una vez importado el panel, puede ver los paneles en Grafana.

A continuación se muestran los paneles de muestra: