Intégration Grafana
Remarque
Contact CAS-PM-Ext@cloud.com pour demander de l’aide pour l’intégration de Grafana, l’exportation de données vers Grafana ou fournir des commentaires.
Vous pouvez intégrer Citrix Analytics for Performance à Grafana à l’aide de l’icône Queue de promtail agent. Cette intégration vous permet d’exporter et de corréler les données de session et d’infrastructure de votre environnement informatique Citrix vers Grafana. Obtenez également des informations plus approfondies sur la posture de sécurité de votre organisation.
Pour plus d’informations sur les points suivants, consultez Exportation de données:
- Avantages de l’intégration
- Le type de données traitées qui sont envoyées à votre plateforme d’observabilité
Prérequis
-
Activez le traitement des données pour au moins une source de données. Il aide Citrix Analytics for Performance à commencer le processus d’intégration de Grafana.
-
Assurez-vous que le point de terminaison suivant figure dans la liste d’autorisation de votre réseau.
Endpoint Région États-Unis Région de l’Union européenne Région Asie-Pacifique Sud Courtiers 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
Intégration avec Grafana
Le diagramme d’architecture suivant explique comment les données circulent de Citrix Analytics for Performance vers la plateforme d’observabilité Grafana :
Configurer le compte d’exportation de données
-
Atteindre Paramètres > Exportations de données.
-
Sur le Configuration du compte , créez un compte en spécifiant le nom d’utilisateur et un mot de passe. Ce compte est utilisé dans le
Queue de promtailfichier de configuration, qui est requis pour l’intégration.
-
Assurez-vous que le mot de passe répond aux conditions suivantes :
Queue de promtail configuration
Le Queue de promtail est un agent qui expédie le contenu des journaux locaux à un Grafana Loki instance ou Grafana Cloud. Vous pouvez installer le Promtail Agent en utilisant Docker, Helm, apt, ou même manuellement.
Promtail est configuré dans un fichier YAML, généralement appelé config.yaml. Ce fichier YAML contient des informations sur le serveur Promtail, où les positions sont stockées et comment extraire les journaux des fichiers.
Voici un exemple Queue de promtail Scrape pour la consommation d’enregistrements à partir 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-->
Sur la base de la configuration précédente, Queue de promtail se connecte aux brokers Citrix Analytics et utilise les enregistrements Citrix Analytics pour les performances. Le sujet Kafka consommé comprend les enregistrements de session et de machine.
Le Queue de promtail sépare les détails de la session et de la machine à l’aide de la commande eventType étiquette, mais ajoute également des étiquettes comme le nom_site et le deliveryGroupName. L’événement horodatage est analysé et remplace la valeur temporelle finale des journaux stockés dans Loki.
Vous pouvez télécharger le fichier de certificat référencé dans la configuration précédente en procédant comme suit :
- Atteindre Analytique Citrix > Paramètres > Exportations de données > Sécurité.
- Cliquez sur l’icône Configuration de l’environnement SIEM et sélectionnez l’icône Autrui option.
-
Téléchargez le fichier PEM et stockez-le dans le système qui héberge le fichier
Queue de promtailagent.
Exemple de tableau de bord Grafana
Vous pouvez importer l’exemple de tableau de bord Grafana fourni par Citrix, qui comprend :
- Mesures
- Tableaux temporels
- Autres visualisations utiles de la télémétrie de session et d’infrastructure.
Vous pouvez télécharger les définitions de tableau de bord (fichiers JSON) à partir du Téléchargements Citrix Analytics page.
Vous pouvez importer les fichiers du tableau de bord dans votre instance Grafana, soit dans un cloud Grafana, soit dans un compte d’entreprise.
Avant d’importer le tableau de bord, assurez-vous d’avoir correctement configuré votre Loki source de données dans Grafana. Lors de l’importation du tableau de bord, vous êtes invité à sélectionner l’icône Loki source de données. Une fois le tableau de bord importé, vous pouvez l’afficher sur Grafana.
Voici des exemples de tableaux de bord :
