Apache

Check de l'Agent

Supported OS:

Dashboard Apache

Présentation

Le check Apache surveille le nombre de requêtes par seconde, les octets traités, les threads de travail, la durée de fonctionnement des services et plus encore.

Configuration

Installation

Le check Apache est fourni avec l’Agent. Pour commencer à recueillir vos logs et métriques Apache, vous devez suivre les étapes suivantes :

Installez l’Agent sur vos serveurs Apache.
Installez mod_status sur vos serveurs Apache et activez ExtendedStatus.

Configuration

Host

Suivez les instructions ci-dessous pour installer et configurer ce check lorsque l’Agent est exécuté sur un host. Consultez la section Environnement conteneurisé pour en savoir plus sur les environnements conteneurisés.

Collecte de métriques

Modifiez le fichier apache.d/conf.yaml dans le dossier conf.d/ à la racine du répertoire de configuration de votre Agent pour commencer à recueillir vos métriques Apache. Consultez le fichier d’exemple apache.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
```
  init_config:

  instances:

      ## @param apache_status_url - string - required
      ## Status url of your Apache server.
      #
    - apache_status_url: http://localhost/server-status?auto
```
Redémarrez l’Agent.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

La collecte de logs est désactivée par défaut dans l’Agent Datadog. Vous devez l’activer dans datadog.yaml :
```
  logs_enabled: true
```

Ajoutez ce bloc de configuration à votre fichier apache.d/conf.yaml pour commencer à recueillir vos logs Apache :

  logs:
      - type: file
        path: /var/log/apache2/access.log
        source: apache
        sourcecategory: http_web_access
        service: apache

      - type: file
        path: /var/log/apache2/error.log
        source: apache
        sourcecategory: http_web_access
        service: apache

Modifiez les valeurs des paramètres path et service et configurez-les pour votre environnement. Consultez le fichier d’exemple apache.d/conf.yaml pour découvrir toutes les options de configuration disponibles.

Redémarrez l’Agent.

Environnement conteneurisé

Consultez la documentation relative aux modèles d’intégration Autodiscovery pour découvrir comment appliquer les paramètres ci-dessous à un environnement conteneurisé.

Collecte de métriques

Paramètre	Valeur
`<NOM_INTÉGRATION>`	`apache`
`<CONFIG_INIT>`	vide ou `{}`
`<CONFIG_INSTANCE>`	`{"apache_status_url": "http://%%host%%/server-status?auto"}`

Collecte de logs

Disponible à partir des versions > 6.5 de l’Agent

La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs avec Docker.

Paramètre	Valeur
`<CONFIG_LOG>`	`{"source": "apache", "service": "<NOM_SERVICE>"}`

Validation

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

Données collectées

Métriques

apache.conns_total (gauge)	The total number of connections performed. Shown as connection
apache.conns_async_writing (gauge)	The number of asynchronous writes connections. Shown as connection
apache.conns_async_keep_alive (gauge)	The number of asynchronous keep alive connections. Shown as connection
apache.conns_async_closing (gauge)	The number of asynchronous closing connections. Shown as connection
apache.net.bytes (gauge)	The total number of bytes served. Shown as byte
apache.net.bytes_per_s (gauge)	The number of bytes served per second. Shown as byte
apache.net.hits (gauge)	The total number of requests performed. Shown as request
apache.net.request_per_s (gauge)	The number of requests performed per second. Shown as request
apache.performance.cpu_load (gauge)	The percent of CPU used. Shown as percent
apache.performance.busy_workers (gauge)	The number of workers serving requests. Shown as thread
apache.performance.idle_workers (gauge)	The number of idle workers. Shown as thread
apache.performance.uptime (gauge)	The amount of time the server has been running. Shown as second

Événements

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

Checks de service

apache.can_connect :
Renvoie CRITICAL si l’Agent n’est pas capable de se connecter à l’URL apache_status_url configurée. Si ce n’est pas le cas, renvoie OK.

Dépannage

URL de statut Apache

Si vous rencontrez des difficultés avec votre intégration Apache, il est fort probable que l’Agent ne soit pas en mesure d’accéder à votre URL de statut Apache. Tentez de faire un curl sur l’URL apache_status_url spécifiée dans votre fichier apache.d/conf.yaml (indiquez vos identifiants de connexion le cas échéant).

Problèmes liés au certificat SSL Apache

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles :