Intégration de Grafana

Remarque :

Contactez CAS-PM-Ext@cloud.com pour demander de l’aide pour l’intégration de Grafana, l’exportation de données vers Grafana ou pour faire part de vos commentaires.

Vous pouvez intégrer Citrix Analytics for Performance à Grafana à l’aide de l’agent Promtail. 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 détaillées sur la posture de sécurité de votre organisation.

Pour plus d’informations sur les points suivants, voir Exportation de données :

• Les avantages de l’intégration
• Le type de données traitées qui sont envoyées à votre plateforme Observability

Pré-requis

• Activez le traitement des données pour au moins une source de données. Cela aide Citrix Analytics for Performance à démarrer 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.

  Point de terminaison	Région des États-Unis	Région de l’Union européenne	Région Asie-Pacifique Sud
  Brokers 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

Intégrez à Grafana

Le schéma d’architecture suivant explique comment les données circulent de Citrix Analytics for Performance vers la plateforme d’observabilité Grafana :

Configurer un compte d’exportation de données

1. Accédez à Paramètres > Exportations de données.

2. Dans la section Configuration du compte, créez un compte en spécifiant le nom d’utilisateur et le mot de passe. Ce compte est utilisé dans le fichier de configuration Promtail, qui est requis pour l’intégration.

   

3. Assurez-vous que le mot de passe répond aux conditions suivantes :

   

Configuration Promtail

Promtail est un agent qui envoie le contenu des journaux locaux à une instance de Grafana Loki privée ou à Grafana Cloud. Vous pouvez l’installer Promtail Agent à l’aide de Docker, Helm, apt ou manuellement.

Promtail est configuré dans un fichier YAML, généralement appelé config.yaml. Ce fichier YAML contient des informations sur le serveur Promtail, sur l’emplacement de stockage des positions et sur la manière de récupérer les journaux des fichiers.

Voici un exemple de configuration de récupération Promtail permettant de consommer des enregistrements provenant 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, Promtail se connecte aux brokers Citrix Analytics et utilise les enregistrements Citrix Analytics for Performance. La rubrique Kafka utilisée inclut les enregistrements de session et de machine.

Promtail sépare les détails de la session et de la machine à l’aide de l’étiquette eventType, mais ajoute également des étiquettes telles que siteName et deliveryGroupName. Le champ d’horodatage des événements 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 suivant les étapes suivantes :

1. Accédez à Citrix Analytics > Paramètres > Exportations de données > Sécurité.
2. Cliquez sur le volet Configuration de l’environnement SIEM et sélectionnez l’option Autres.

3. Téléchargez le fichier PEM et stockez-le dans le système qui héberge l’agentPromtail.

   

Exemple de tableau de bord Grafana

Vous pouvez importer l’exemple de tableau de bord Grafana fourni par Citrix, qui inclut :

• Métriques
• Graphiques temporels
• Autres visualisations utiles de la télémétrie des sessions et de l’infrastructure.

Vous pouvez télécharger les définitions du tableau de bord (fichiers JSON) depuis la page de téléchargement de Citrix Analytics.

Vous pouvez importer les fichiers du tableau de bord dans votre instance Grafana, soit vers un cloud Grafana, soit vers un compte d’entreprise.

Avant d’importer le tableau de bord, assurez-vous d’avoir correctement configuré votre source de données Loki dans Grafana. Lors de l’importation du tableau de bord, vous êtes invité à sélectionner la source de données Loki. Une fois le tableau de bord importé, vous pouvez consulter les tableaux de bord sur Grafana.

Voici les exemples de tableaux de bord :