
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 Datadog. 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
Pour configurer ce check lorsque l’Agent est exécuté sur un host :
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
:
Ajoutez le bloc de configuration suivant à votre fichier apache.d/conf.yaml
pour commencer à recueillir vos logs Apache. Modifiez les valeurs path
et service
en fonction de votre environnement :
logs:
- type: file
path: /path/to/your/apache/access.log
source: apache
service: apache
sourcecategory: http_web_access
- type: file
path: /path/to/your/apache/error.log
source: apache
service: apache
sourcecategory: http_web_error
Consultez le fichier d’exemple apache.d/conf.yaml pour découvrir toutes les options de configuration disponibles.
Redémarrez l’Agent.
Docker
Pour configurer ce check lorsque l’Agent est exécuté sur un conteneur :
Collecte de métriques
Définissez des modèles d’intégration Autodiscovery en tant qu’étiquettes Docker sur votre conteneur d’application :
LABEL "com.datadoghq.ad.check_names"='["apache"]'
LABEL "com.datadoghq.ad.init_configs"='[{}]'
LABEL "com.datadoghq.ad.instances"='[{"apache_status_url": "http://%%host%%/server-status?auto"}]'
Collecte de logs
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.
Définissez ensuite des [intégrations de logs][5] en tant qu’étiquettes Docker :
LABEL "com.datadoghq.ad.logs"='[{"source": "apache", "service": "<NOM_SERVICE>"}]'
Kubernetes
Pour configurer ce check lorsque l’Agent est exécuté sur Kubernetes :
Collecte de métriques
Définissez des modèles d’intégration Autodiscovery en tant qu’annotations de pod sur votre conteneur d’application. Cette configuration peut également être réalisée avec un fichier, une configmap ou une paire key/value.
apiVersion: v1
kind: Pod
metadata:
name: apache
annotations:
ad.datadoghq.com/apache.check_names: '["apache"]'
ad.datadoghq.com/apache.init_configs: '[{}]'
ad.datadoghq.com/apache.instances: |
[
{
"apache_status_url": "http://%%host%%/server-status?auto"
}
]
spec:
containers:
- name: apache
Collecte de logs
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.
Définissez ensuite des intégrations de logs en tant qu’annotations de pod. Cette configuration peut également être réalisée avec un fichier, une configmap ou une paire key/value.
apiVersion: v1
kind: Pod
metadata:
name: apache
annotations:
ad.datadoghq.com/apache.logs: '[{"source":"apache","service":"<NOM_SERVICE>"}]'
spec:
containers:
- name: apache
ECS
Pour configurer ce check lorsque l’Agent est exécuté sur ECS :
Collecte de métriques
Définissez des modèles d’intégration Autodiscovery en tant qu’étiquettes Docker sur votre conteneur d’application :
{
"containerDefinitions": [{
"name": "apache",
"image": "apache:latest",
"dockerLabels": {
"com.datadoghq.ad.check_names": "[\"apache\"]",
"com.datadoghq.ad.init_configs": "[{}]",
"com.datadoghq.ad.instances": "[{\"apache_status_url\": \"http://%%host%%/server-status?auto\"}]"
}
}]
}
Collecte de logs
La collecte des logs est désactivée par défaut dans l’Agent Datadog. Pour l’activer, consultez la section Collecte de logs Amazon ECS.
Définissez ensuite des [intégrations de logs][5] en tant qu’étiquettes Docker :
{
"containerDefinitions": [{
"name": "apache",
"image": "apache:latest",
"dockerLabels": {
"com.datadoghq.ad.logs": "[{\"source\":\"apache\",\"service\":\"<VOTRE_APPLICATION>\"}]"
}
}]
}
Validation
Lancez la sous-commande status de l’Agent et cherchez apache
dans la section Checks.
Données collectées
Métriques
É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’instance Apache qu’il surveille. Si ce n’est pas le cas, renvoie OK
.
Statuses: ok, critical
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 d’exécuter curl pour la 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 :