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
-
Vaya a Configuración > Exportación de datos.
-
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. -
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:
- Vaya a Citrix Analytics > Parámetros > Exportaciones de datos > Seguridad.
- Haga clic en el panel Configuración del entorno SIEM y seleccione la opción Otros.
-
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: