Apache

Apache

Agent Check Check de l'Agent

Supported OS Linux Mac OS Windows

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 :

  1. Installez l’Agent sur vos serveurs Apache.

  2. Installez mod_status sur vos serveurs Apache et activez ExtendedStatus.

Configuration

Host

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

Collecte de métriques
  1. 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
    
  2. Redémarrez l’Agent.

Collecte de logs

Disponible à partir des versions > 6.0 de l’Agent

  1. 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
    
  2. 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
        service: apache
    
      - type: file
        path: /var/log/apache2/error.log
        source: apache
        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.

  3. 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.0 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 Kubernetes.

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.max_workers
(gauge)
The maximum number of workers apache can start.
Shown as thread
apache.performance.uptime
(gauge)
The amount of time the server has been running.
Shown as second
apache.scoreboard.waiting_for_connection
(gauge)
The number of workers that can immediately process an incoming request.
Shown as thread
apache.scoreboard.starting_up
(gauge)
The workers that are still starting up and not yet able to handle a request.
Shown as thread
apache.scoreboard.reading_request
(gauge)
The workers reading the incoming request.
Shown as thread
apache.scoreboard.sending_reply
(gauge)
The number of workers sending a reply/response or waiting on a script (like PHP) to finish so they can send a reply.
Shown as thread
apache.scoreboard.keepalive
(gauge)
The workers intended for a new request from the same client, because it asked to keep the connection alive.
Shown as thread
apache.scoreboard.dns_lookup
(gauge)
The workers waiting on a DNS lookup.
Shown as thread
apache.scoreboard.closing_connection
(gauge)
The amount of workers that are currently closing a connection.
Shown as thread
apache.scoreboard.logging
(gauge)
The workers writing something to the Apache logs.
Shown as thread
apache.scoreboard.gracefully_finishing
(gauge)
The number of workers finishing their request.
Shown as thread
apache.scoreboard.idle_cleanup
(gauge)
These workers were idle and their process is being stopped.
Shown as thread
apache.scoreboard.open_slot
(gauge)
The amount of workers that Apache can still start before hitting the maximum number of workers.
Shown as thread
apache.scoreboard.disabled
(gauge)
These slots will never be able to handle any requests, indicates a misconfiguration.
Shown as thread

Événements

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

Checks de service

apache.can_connect :
Renvoie CRITICAL si l’Agent ne parvient pas à 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).

Pour aller plus loin

Documentation, liens et articles supplémentaires utiles :