OpenShift

Présentation

Red Hat OpenShift est une plateforme d’applications de conteneur open source basée sur l’orchestrateur de conteneurs Kubernetes pour le développement et le déploiement d’applications d’entreprise.

Il n’existe aucun check openshift distinct. Cette page décrit la configuration nécessaire pour activer la collecte des métriques propres à OpenShift dans l’Agent. Les données décrites ici sont recueillies par le check kubernetes_apiserver. La configuration de ce check est nécessaire pour recueillir les métriques openshift.*.

Configuration

Installation

Pour installer l’Agent, consultez les instructions d’installation de l’Agent pour Kubernetes. La configuration par défaut a été conçue pour OpenShift 3.7.0+ et OpenShift 4.0+, car elle repose sur des fonctionnalités et des endpoints inclus avec ces versions.

Configuration

Si vous déployez l’Agent Datadog en utilisant l’une des méthodes présentées dans les instructions d’installation ci-dessus, vous devez inclure les contraintes de contexte de sécurité (Security Context Constraints ou SCC) pour que l’Agent recueille des données. Suivez les instructions ci-dessous en fonction de votre déploiement.

...
agents:
...
  podSecurity:
    securityContextConstraints:
      create: true
...

Collecte de logs

Consultez la section Collecte de logs Kubernetes pour en savoir plus.

Opérations avec SCC restreintes

Ce mode ne nécessite pas l’octroi d’autorisations spéciales au daemonset datadog-agent, à l’exception des autorisations RBAC qui permettent d’accéder à Kubelet et à l’APIserver. Pour commencer, utilisez ce modèle destiné à Kubelet.

La méthode d’ingestion conseillée pour Dogstatsd, APM et les logs consiste à binder l’Agent Datadog sur un port du host. Ainsi, l’IP cible reste fixe et peut facilement être identifiée par vos applications. Les SCC OpenShift restreintes par défaut ne permettent pas de binder sur un port du host. Vous pouvez configurer l’Agent de façon à ce qu’il effectue l’écoute sur sa propre adresse IP. Toutefois, dans ce cas-là, vous devez vous-même configurer la détection de cette IP depuis votre application.

L’Agent peut être lancé en mode sidecar, ce qui vous permet de l’exécuter dans le pod de votre application pour une identification simplifiée.

Host

Ajoutez l’autorisation allowHostPorts au pod, avec la SCC hostnetwork ou hostaccess standard, ou en créant votre propre SCC. Dans ce cas, vous pouvez ajouter les bindings de port appropriés dans les spécifications de vos pods :

ports:
  - containerPort: 8125
    name: dogstatsdport
    protocol: UDP
  - containerPort: 8126
    name: traceport
    protocol: TCP

SCC Datadog personnalisées pour un accès à toutes les fonctionnalités

Si SELinux est en mode permissif ou désactivé, activez la SCC hostaccess pour profiter de toutes les fonctionnalités. Si SELinux est en mode strict, il est conseillé d’accorder le type spc_t au pod datadog-agent. Pour déployer votre Agent, Datadog a créé une SCC datadog-agent que vous pouvez appliquer après la création du compte du service datadog-agent. Cette SCC accorde les autorisations suivantes :

• allowHostPorts: true : permet de binder les admissions Dogstatsd/APM/Logs sur l’IP du nœud.
• allowHostPID: true : permet la détection de l’origine des métriques DogStatsD envoyées par le socket Unix.
• volumes: hostPath : accède au socket Docker et aux dossiers proc et cgroup du host afin de recueillir les métriques.
• SELinux type: spc_t : accède au socket Docker et aux dossiers proc et cgroup de tous les processus afin de recueillir les métriques. Consultez la section Présentation du concept de conteneur avec super privilèges pour en savoir plus.

Remarque : le socket Docker appartient au groupe root. Vous devez donc élever les privilèges de l’Agent pour pouvoir récupérer les métriques Docker. Pour exécuter le processus de l’Agent en tant qu’utilisateur root, vous pouvez configurer votre SCC de la façon suivante :

runAsUser:
  type: RunAsAny

Validation

Consultez kubernetes_apiserver

Données collectées

Métriques

Événements

Le check OpenShift n’inclut aucun événement.

Checks de service

Le check OpenShift n’inclut aucun check de service.

Dépannage

Besoin d’aide ? Contactez l’assistance Datadog.