Contrôleur d'entrée Citrix ADC

Prise en charge de la configuration d’Analytics à l’

Vous pouvez utiliser Citrix Observability Exporter pour exporter des mesures et des transactions à partir de Citrix ADC CPX, MPX ou VPX et analyser les données exportées afin d’obtenir des informations pertinentes. La prise en charge de Citrix Observability Exporter est activée dans la configuration du Citrix ingress controller. Vous pouvez désormais activer la configuration de Citrix Observability Exporter dans le Citrix ingress controller à l’aide d’un ConfigMap.

Variables d’environnement prises en charge pour la configuration de l’analytique à

Vous pouvez configurer les paramètres suivants sous NS_ANALYTICS_CONFIG à l’aide d’une ConfigMap :

  • distributed_tracing: Cette variable active ou désactive OpenTracing dans Citrix ADC et possède les attributs suivants :

    • enable: définissez cette valeur sur true pour activer OpenTracing. La valeur par défaut est false.
    • samplingrate: spécifie le taux d’échantillonnage OpenTracing en pourcentage. La valeur par défaut est 100.
  • endpoint: spécifie l’adresse IP ou l’adresse DNS du serveur d’analyse.

    • server: définissez cette valeur en tant qu’adresse IP ou adresse DNS du serveur.
    • service: spécifie l’adresse IP ou le nom du service d’exportation d’observabilité Citrix ADC selon que le service s’exécute sur une machine virtuelle ou en tant que service Kubernetes. Si l’instance d’exportateur d’observabilité Citrix ADC s’exécute sur une machine virtuelle, ce paramètre spécifie l’adresse IP. Si l’instance d’exportateur d’observabilité Citrix ADC s’exécute en tant que service dans le cluster Kubernetes, ce paramètre spécifie l’instance en tant qu’espace de nommage/nom de service.
  • timeseries: permet d’exporter des données de séries chronologiques à partir de Citrix ADC. Vous pouvez spécifier les attributs suivants pour la configuration des séries chronologiques.

    • port: spécifie le numéro de port du point de fin de série chronologique du serveur d’analyse. La valeur par défaut est 5563.
    • metrics: permet d’exporter des métriques depuis Citrix ADC.
      • enable: définissez cette valeur sur true pour activer l’envoi de mesures. La valeur par défaut est false.
      • mode: spécifie le mode du point de terminaison de la mesure. La valeur par défaut est avro.
    • auditlogs: permet d’exporter les données du journal d’audit à partir de Citrix ADC.
      • enable: définissez cette valeur sur true pour activer les données du journal d’audit. La valeur par défaut est false.
    • events: permet d’exporter des événements depuis Citrix ADC.
      • enable: définissez cette valeur sur true pour activer l’exportation d’événements. La valeur par défaut est false.
  • transactions: permet d’exporter des transactions depuis Citrix ADC.

    • enable: définissez cette valeur sur true pour activer l’envoi de transactions. La valeur par défaut est false.
    • port: spécifie le numéro de port du point de terminaison transactionnel du serveur d’analyse. La valeur par défaut est 5557.

Les configurations suivantes ne peuvent pas être modifiées lorsque le Citrix ingress controller est en cours d’exécution et vous devez redémarrer le Citrix ingress controller pour appliquer ces paramètres.

  • configuration du serveur (point de terminaison)
  • configuration des ports (série chronologique)
  • configuration des ports (transactions)

Vous pouvez modifier d’autres paramètres ConfigMap lors de l’exécution lorsque le Citrix ingress controller est en cours d’exécution.

Remarque :

Lorsque l’utilisateur spécifie la valeur d’un service en tant que namespace/service name, Citrix ingress controller dérive le point de terminaison associé à ce service et le lie dynamiquement au groupe de services transactionnels dans Citrix Tier-1 ADC. Si un utilisateur spécifie la valeur d’un service en tant qu’adresse IP, l’adresse IP est directement liée au groupe de services transactionnels. Citrix ingress controller a été amélioré pour créer des profils d’analyse Web ou TCP par défaut et les lier au serveur virtuel de journalisation. Les profils d’analyse par défaut sont liés à tous les serveurs virtuels d’applications d’équilibrage de charge si l’exportateur d’observabilité Citrix ADC est activé dans le cluster. Si l’utilisateur souhaite modifier le profil d’analyse, il peut utiliser l’annotation analyticsprofile.

Les attributs de NS_ANALYTICS_CONFIG doivent suivre un schéma bien défini. Si l’une des valeurs fournies ne confirme pas le schéma, la configuration complète est rejetée. Pour référence, consultez le fichier de schéma ns_analytics_config_schema.yaml.

Création d’une configuration ConfigMap pour les analyses

Cette rubrique fournit des informations sur la façon de créer une configuration ConfigMap pour les analyses.

Créez un fichier YAML cic-configmap.yaml avec les paires clé-valeur requises dans ConfigMap.

  apiVersion: v1
  kind: ConfigMap
  metadata:
    name: cic-configmap
    labels:
      app: citrix-ingress-controller
  data:
    LOGLEVEL: 'info'
    NS_PROTOCOL: 'http'
    NS_PORT: '80'
    NS_HTTP2_SERVER_SIDE: 'ON'
    NS_ANALYTICS_CONFIG: |
      distributed_tracing:
        enable: 'false'
        samplingrate: 100
      endpoint:
        server: '1.1.1.1'
        service: 'default/coe-kafka'
      timeseries:
        port: 5563
        metrics:
          enable: 'false'
          mode: 'avro'
        auditlogs:
          enable: 'false'
        events:
          enable: 'false'
      transactions:
        enable: 'true'
        port: 5557

Pour plus d’informations sur la façon de configurer la prise en charge de ConfigMap sur le Citrix ingress controller, consultez Configuration de la prise en charge de ConfigMap pour le Citrix ingress controller.

Schéma pour NS_ANALYTICS_CONFIG

Voici le schéma pour NS_ANALYTICS_CONFIG. Les attributs doivent être conformes à ce schéma.

type: map
mapping:
  NS_ANALYTICS_CONFIG:
    required: no
    type: map
    mapping:
      endpoint:
        required: yes
        type: map
        mapping:
          server:
            required: yes
            type: str
      distributed_tracing:
        required: no
        type: map
        mapping:
          enable:
            required: yes
            type: str
            enum:
              - 'true'
              - 'false'
          samplingrate:
            required: no
            type: int
            range:
              max: 100
              min: 0
      timeseries:
        required: no
        type: map
        mapping:
          port:
            required: no
            type: int
          metrics:
            required: no
            type: map
            mapping:
              enable:
                required: yes
                type: str
                enum:
                  - 'true'
                  - 'false'
              mode:
                required: yes
                type: str
                enum:
                  - prometheus
                  - avro
                  - influx
          auditlogs:
            required: no
            type: map
            mapping:
              enable:
                required: yes
                type: str
                enum:
                  - 'true'
                  - 'false'
          events:
            required: no
            type: map
            mapping:
              enable:
                required: yes
                type: str
                enum:
                  - 'true'
                  - 'false'
      transactions:
        required: no
        type: map
        mapping:
          enable:
            required: yes
            type: str
            enum:
              - 'true'
              - 'false'
          port:
            required: no
            type: int
Prise en charge de la configuration d’Analytics à l’