Systemd

Supported OS Linux

Présentation

Ce check permet de surveiller Systemd ainsi que les unités qu’il gère avec l’Agent Datadog.

  • Surveillez l’état et la santé de votre Systemd.
  • Surveillez les unités, les services et les sockets gérés par Systemd.

Configuration

Installation

Le check Systemd est inclus avec le package de l’Agent Datadog. Vous n’avez donc rien à installer sur votre serveur.

Configuration

    Host

    Pour configurer ce check lorsque l’Agent est exécuté sur un host :

    1. Modifiez le fichier systemd.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos données de performance Systemd. Consultez le fichier d’exemple systemd.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

    2. Redémarrez l’Agent.

    Environnement conteneurisé

    Pour les environnements conteneurisés, montez le dossier /run/systemd/, qui contient le socket /run/systemd/private nécessaire pour récupérer les données Systemd. Exemple :

    docker run -d -v /var/run/docker.sock:/var/run/docker.sock:ro \
              -v /proc/:/host/proc/:ro \
              -v /sys/fs/cgroup/:/host/sys/fs/cgroup/:ro \
              -v /run/systemd/:/host/run/systemd/:ro \
              -e DD_API_KEY=<VOTRE_CLÉ_API> \
              datadog/agent:latest

    Validation

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

    Données collectées

    Métriques

    systemd.service.cpu_time_consumed
    (gauge)    		The overall cpu consumed by the service in nanoseconds (CPUUsageNSec), requires Systemd configuration CPUAccounting to be enabled and Systemd version >= 220
    Shown as nanosecond
    systemd.service.memory_usage
    (gauge)    		The memory currently used by the service in bytes (MemoryCurrent), requires Systemd configuration MemoryAccounting to be enabled
    Shown as byte
    systemd.service.restart_count
    (gauge)    		The number of times the service has been restarted due to Restart= (NRestarts), requires Systemd version >= 235
    Shown as time
    systemd.service.task_count
    (gauge)    		The current number of tasks in the service (TasksCurrent), requires Systemd configuration TasksAccounting to be enabled
    Shown as task
    systemd.socket.connection_accepted_count
    (gauge)    		The number of accepted socket connections (NAccepted)
    Shown as connection
    systemd.socket.connection_count
    (gauge)    		The current number of socket connections (NConnections)
    Shown as connection
    systemd.socket.connection_refused_count
    (gauge)    		The total number of refused socket connections (NRefused), requires Systemd version >= 239
    Shown as connection
    systemd.unit.active
    (gauge)    		Whether the unit is currently in active state
    systemd.unit.loaded
    (gauge)    		Whether the unit is currently in loaded state
    systemd.unit.monitored
    (gauge)    		Indicates that the unit is monitored (the value is always 1)
    systemd.unit.uptime
    (gauge)    		The unit uptime in seconds since it's activation
    Shown as second
    systemd.units_by_state
    (gauge)    		Sum by state to count units
    Shown as unit
    systemd.units_loaded_count
    (gauge)    		The number of loaded units
    Shown as unit
    systemd.units_monitored_count
    (gauge)    		The number of monitored units
    Shown as unit
    systemd.units_total
    (gauge)    		The total number of units
    Shown as unit

    Certaines métriques sont uniquement transmises si leur configuration respective est activée :

    • systemd.service.cpu_time_consumed nécessite l’activation de la configuration CPUAccounting de Systemd.
    • systemd.service.memory_usage nécessite l’activation de la configuration MemoryAccounting de Systemd.
    • systemd.service.task_count nécessite l’activation de la configuration TasksAccounting de Systemd.

    Certaines métriques ne sont disponibles qu’à partir d’une version spécifique de Systemd :

    • systemd.service.cpu_time_consumed nécessite l’installation de Systemd v220.
    • systemd.service.restart_count nécessite l’installation de Systemd v235.
    • systemd.socket.connection_refused_count nécessite l’installation de Systemd v239.

    Événements

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

    Checks de service

    systemd.can_connect
    Returns OK if Systemd is reachable, CRITICAL otherwise.
    Statuses: ok, critical

    systemd.system.state
    Returns OK if Systemd’s system state is running. Returns CRITICAL if the state is degraded, maintenance, or stopping. Returns UNKNOWN if the state is initializing, starting, or other.
    Statuses: ok, critical, unknown

    systemd.unit.state
    Returns OK if the unit active state is active. Returns CRITICAL if the state is inactive, deactivating, or failed. Returns UNKNOWN if the state is activating or other.
    Statuses: ok, critical, unknown

    systemd.unit.substate
    Returns OK CRITICAL or UNKNOWN based on the substate of the unit and the user-provided mapping in systemd.d/conf.yaml.
    Statuses: ok, critical, unknown

    Dépannage

    Besoin d’aide ? Contactez l’assistance Datadog.

    PREVIEWING: may/unit-testing