Prise en charge de la configuration d’Analytics à l’
Vous pouvez utiliser NetScaler Observability Exporter pour exporter des métriques et des transactions depuis NetScaler CPX, MPX ou VPX et analyser les données exportées afin d’obtenir des informations pertinentes. Le support de NetScaler Observability Exporter est activé dans la configuration de NetScaler Ingress Controller. Vous pouvez désormais activer la configuration de NetScaler Observability Exporter dans le NetScaler Ingress Controller à l’aide d’une 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 NetScaler et possède les attributs suivants :-
enable: définissez cette valeur surtruepour activer OpenTracing. La valeur par défaut estfalse. -
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 de service du service NetScaler Observability Exporter selon que le service s’exécute sur une machine virtuelle ou en tant que service Kubernetes. Si l’instance NetScaler Observability Exporter s’exécute sur une machine virtuelle, ce paramètre spécifie l’adresse IP. Si l’instance NetScaler Observability Exporter s’exécute en tant que service dans le cluster Kubernetes, ce paramètre spécifie l’instance en tant qu’espace de noms/nom de service.
-
-
timeseries: permet d’exporter des données de séries chronologiques depuis NetScaler. 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 NetScaler.-
enable: définissez cette valeur surtruepour activer l’envoi de mesures. La valeur par défaut estfalse. -
mode: spécifie le mode du point de terminaison de la mesure. La valeur par défaut estavro.
-
-
auditlogs: permet d’exporter les données du journal d’audit depuis NetScaler.-
enable: définissez cette valeur surtruepour activer les données du journal d’audit. La valeur par défaut estfalse.
-
-
events: permet d’exporter des événements depuis NetScaler.-
enable: définissez cette valeur surtruepour activer l’exportation d’événements. La valeur par défaut estfalse.
-
-
-
transactions: permet d’exporter des transactions depuis NetScaler.-
enable: définissez cette valeur surtruepour activer l’envoi de transactions. La valeur par défaut estfalse. -
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 NetScaler Ingress Controller est en cours d’exécution et vous devez redémarrer le NetScaler 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 de ConfigMap lors de l’exécution pendant que le NetScaler 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, NetScaler Ingress Controller dérive le point de terminaison associé à ce service et le lie dynamiquement au groupe de services transactionnels dans NetScaler 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. NetScaler Ingress Controller est 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’équilibrage de charge des applications si l’exportateur NetScaler Observability est activé dans le cluster. Si l’utilisateur souhaite modifier le profil d’analyse, il peut utiliser l’annotationanalyticsprofile.
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 NetScaler Ingress Controller, consultez la section Configuration de la prise en charge de ConfigMap pourle NetScaler 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