Gatekeeper

Présentation

Ce check recueille des métriques à partir de Gatekeeper OPA.

Configuration

Suivez les instructions ci-dessous pour installer et configurer ce check pour un Agent exécuté sur un cluster Kubernetes. Consultez également la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer ces instructions.

Installation

Agent v7.26.0/v6.26.0 ou ultérieur

Pour utiliser une intégration provenant du référentiel integrations-extra avec l’Agent Docker, nous vous recommandons de générer l’Agent avec l’intégration installée. Utilisez le Dockerfile suivant pour créer une version mise à jour de l’Agent comprenant l’intégration gatekeeper issue de integrations-extras :

FROM gcr.io/datadoghq/agent:latest
RUN agent integration install -r -t datadog-gatekeeper==<VERSION_INTÉGRATION>

Versions antérieures de l’Agent

Pour installer le check gatekeeper sur votre cluster Kubernetes :

1. Installez le kit de développement.

2. Clonez le dépôt integrations-extras :

   git clone https://github.com/DataDog/integrations-extras.git.
   

3. Mettez à jour votre configuration ddev avec le chemin integrations-extras/ :

   ddev config set extras ./integrations-extras
   

4. Pour générer le package gatekeeper, exécutez :

   ddev -e release build gatekeeper
   

5. Téléchargez le manifeste de l’Agent pour installer l’Agent Datadog en tant que DaemonSet.

6. Créez deux PersistentVolumeClaim, un pour le code des checks et l’autre pour la configuration.

7. Ajoutez-les en tant que volumes au modèle de pod de l’Agent, puis utilisez-les pour vos checks et votre configuration :

        env:
          - name: DD_CONFD_PATH
            value: "/confd"
          - name: DD_ADDITIONAL_CHECKSD
            value: "/checksd"
      [...]
        volumeMounts:
          - name: agent-code-storage
            mountPath: /checksd
          - name: agent-conf-storage
            mountPath: /confd
      [...]
      volumes:
        - name: agent-code-storage
          persistentVolumeClaim:
            claimName: agent-code-claim
        - name: agent-conf-storage
          persistentVolumeClaim:
            claimName: agent-conf-claim
   

8. Déployez l’Agent Datadog sur votre cluster Kubernetes :

   kubectl apply -f agent.yaml
   

9. Copiez le fichier d’artefact de l’intégration (.whl) sur vos nœuds Kubernetes ou importez-le sur une URL publique.

10. Exécutez la commande suivante pour installer le wheel de l’intégration à l’aide de l’Agent :

    kubectl exec ds/datadog -- agent integration install -w <PATH_OF_GATEKEEPER_ARTIFACT_>/<GATEKEEPER_ARTIFACT_NAME>.whl
    

11. Exécutez les commandes suivantes pour copier les checks et la configuration sur les PVC correspondants :

    kubectl exec ds/datadog -- sh
    # cp -R /opt/datadog-agent/embedded/lib/python3.8/site-packages/datadog_checks/* /checksd
    # cp -R /etc/datadog-agent/conf.d/* /confd
    

12. Redémarrez les pods de l’Agent Datadog.

Configuration

1. Modifiez le fichier gatekeeper/conf.yaml dans le dossier /confd que vous avez ajouté au pod de l’Agent pour commencer à recueillir vos données de performance gatekeeper. Consultez le fichier d’exemple gatekeeper/conf.yaml pour découvrir toutes les options de configuration disponibles.

2. Redémarrez l’Agent.

Validation

Lancez la sous-commande status de l’Agent et cherchez gatekeeper dans la section Checks.

Données collectées

Métriques

Événements

Gatekeeper n’inclut aucun événement.

Checks de service

gatekeeper.prometheus.health
Returns CRITICAL if the agent fails to connect to the Prometheus metrics endpoint, otherwise OK.
Statuses: ok, critical

gatekeeper.health
Returns CRITICAL if the agent fails to connect to the gatekeeper health endpoint, OK if it returns 200, WARNING otherwise.
Statuses: ok, warning, critical

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.