Monitorer NGINX Plus auto-hébergé avec OpenTelemetry

Monitorez vos serveurs NGINX Plus fonctionnant sur un hôte en utilisant le collecteur NRDOT (recommandé) ou l'OpenTelemetry Collector pour envoyer des métriques et des données télémétriques à New Relic.

Cette intégration exploite le prometheusreceiver et le nginx-prometheus-exporter OpenTelemetry pour monitorer les métriques de performance, les statistiques de connexion et l'état du serveur de votre NGINX Plus. La riche API HTTP de NGINX Plus fournit des métriques beaucoup plus détaillées que le module d'état stub de base dans NGINX standard.

Dashboard disponible via le démarrage rapide New Relic NGINX OpenTelemetry Monitor.

Avant de commencer

Assurez-vous d'avoir :

Clé de licenceNew Relic valide
Version NGINX Plus R13 ou supérieure
NGINX Plus avec le module HTTP API activé
Exportateur Prometheus NGINX installé et fonctionnant aux côtés de votre instance NGINX Plus pour exposer les métriques de l'API HTTP au format Prometheus
L'un des collecteurs suivants installés sur un hôte Linux :
- collecteur NRDOT (recommandé - distribution OpenTelemetry de New Relic), ou
- OpenTelemetry Collector Contrib (option alternative)
Accès réseau de l'hôte Linux vers :
- Point de terminaison de l'API HTTP NGINX Plus
- Un point de terminaison New Relic OTLP

Configurer le monitoring de NGINX Plus

Choisissez votre collecteur préféré et suivez les étapes de configuration :

Conseil

Si une étape de vérification échoue, installez les composants manquants avant de poursuivre. Besoin d'aide pour installer le collecteur NRDOT ? Consultez la section d'installation du référentiel nrdot-collector-releases.

Lors de l'installation, utilisez export collector_distro="nrdot-collector"

Configurer le collecteur NRDOT

Configurez le collecteur NRDOT pour extraire les métriques de votre exportateur Prometheus NGINX Plus et les envoyer à New Relic.

Pour le collecteur NRDOT, créez un fichier de configuration de monitoring NGINX Plus autonome qui remplace la configuration par défaut.

Important

Monitoring autonome vs combiné: cette configuration monitore uniquement les serveurs NGINX Plus. Si vous avez également besoin de métriques d'hôte (CPU, mémoire, disque) ou de logs système, utilisez la configuration par défaut du collecteur NRDOT qui inclut les récepteurs hostmetrics et filelog, et ajoutez-y le récepteur prometheus.

Créez /etc/nrdot-collector/nginx-plus-config.yaml avec le contenu suivant :

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: 'nginx-plus'
          scrape_interval: 30s
          static_configs:
            - targets: ['<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>']
processors:
  batch:
    send_batch_size: 1024
    timeout: 30s
  filter/nginx_metrics:
    metrics:
      include:
        match_type: regexp
        metric_names:
          - "nginxplus_connections_.*"
          - "nginxplus_http_requests_.*"
          - "nginxplus_ssl_.*"
      exclude:
        match_type: regexp
        metric_names:
          - "nginxplus_server_.*"
          - "nginxplus_location_zone_.*"
          - "nginxplus_cache_.*"
          - "nginxplus_stream_server_.*"
          - "nginxplus_upstream_.*"
          - "nginxplus_stream_upstream_.*"
          - "nginxplus_stream_zone_sync_zone_.*"
          - "nginxplus_resolver_.*"
          - "nginxplus_limit_request_.*"
          - "nginxplus_limit_connection_.*"
          - "nginxplus_stream_limit_connection_.*"
          - "nginxplus_worker_.*"
  resource/nginx:
    attributes:
      - key: nginx.server.endpoint
        value: "<YOUR_API_STATUS_ENDPOINT>"  # Replace with your endpoint
        action: insert
      - key: nginx.deployment.name
        value: "<DEPLOYMENT_NAME>"                    # Replace with your deployment server name
        action: insert
  resourcedetection:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: true
        host.id:
          enabled: true
  transform/nginx:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
      - context: resource
        statements:
          - delete_key(attributes, "service.name")
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")
exporters:
  otlp_http:
    endpoint: ${env:YOUR_NEWRELIC_OTLP_ENDPOINT}
    headers:
      api-key: ${env:YOUR_NEW_RELIC_LICENSE_KEY}
service:
  pipelines:
    metrics/nginx:
      receivers: [prometheus]
      processors: [batch, filter/nginx_metrics, resourcedetection, resource/nginx, transform/nginx, transform/metadata_nullify]
      exporters: [otlp_http]

Paramètres de configuration

Le tableau suivant décrit les principaux paramètres de configuration :

paramètres	Description
`<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>`	Remplacez par le point de terminaison de l'exportateur Prometheus (par exemple « 127.0.0.1:9113 »)
`<YOUR_API_STATUS_ENDPOINT>`	Remplacez par le point de terminaison de statut de l'API du serveur NGINX Plus (par exemple http:/127.0.0.1/api/9)
`<DEPLOYMENT_NAME>`	Remplacez par un nom de déploiement unique pour ce serveur NGINX Plus (par exemple `production-web-01` , `staging-api` , `prod-lb-01` )
`scrape_interval`	Intervalle en secondes pour collecter les métriques. La valeur par défaut est définie sur `30s`
`send_batch_size`	Nombre de métriques à regrouper par lot avant l'envoi. La valeur par défaut est définie sur `1024`
`timeout`	Délai d'attente en secondes avant d'envoyer les métriques groupées. La valeur par défaut est définie sur `30s`

Par défaut, la configuration collecte uniquement les métriques de base (connexions, requests HTTP et SSL). Pour activer des catégories de métriques supplémentaires :

Identifiez les métriques que vous souhaitez activer à partir de la liste des métriques ci-dessous et notez la catégorie à laquelle elles appartiennent.
Déplacez le préfixe de métrique correspondant de exclude à include dans le processeur filter/nginx_metrics.
Exemple : Activer les métriques HTTP Server Zones

Trouvez cette ligne dans la section exclude :

filter/nginx_metrics:
  metrics:
    include:
    # existing include metrics
    exclude:
      match_type: regexp
      metric_names:
        - "nginxplus_server_.*"

Déplacez-le dans la section include :

filter/nginx_metrics:
  metrics:
    include:
      match_type: regexp
      metric_names:
        - "nginxplus_connections_.*"
        - "nginxplus_http_requests_.*"
        - "nginxplus_ssl_.*"
        - "nginxplus_server_.*"  # Added to enable server zone metrics
    exclude:
      match_type: regexp
      metric_names:
        # Remove "nginxplus_server_.*" from here
        - "nginxplus_location_zone_.*"
        - "nginxplus_cache_.*"
        # ... rest of exclude list

Redémarrez le collecteur après avoir effectué des modifications :
bash
```
$sudo systemctl restart nrdot-collector.service
```

Configurer l'environnement et mettre à jour le chemin de configuration

Mettez à jour la configuration du collecteur NRDOT pour utiliser votre fichier de configuration NGINX Plus et définissez le point de terminaison OTLP.

Déterminez votre point de terminaison OTLP en fonction de votre région New Relic. Consultez Configurer le point de terminaison, le port et le protocole pour la liste complète des points de terminaison et des ports pris en charge pour votre région.

Important

Votre clé de licence a déjà été configurée dans /etc/nrdot-collector/nrdot-collector.conf lors de l'installation. Il vous suffit de mettre à jour le chemin du fichier de configuration et le point de terminaison OTLP.

Mettez à jour le fichier de configuration du collecteur :

bash

$export collector_distro="nrdot-collector"
$export otlp_endpoint="YOUR_NEWRELIC_OTLP_ENDPOINT"  # Replace with your region's endpoint
$
$# Update the config file path to point to nginx-plus-config.yaml
$sudo sed -i 's|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/config.yaml"|OTELCOL_OPTIONS="--config=/etc/nrdot-collector/nginx-plus-config.yaml"|' /etc/${collector_distro}/${collector_distro}.conf
$
$# Add the OTLP endpoint
$echo "OTEL_EXPORTER_OTLP_ENDPOINT=${otlp_endpoint}" | sudo tee -a /etc/${collector_distro}/${collector_distro}.conf > /dev/null

(Facultatif) Transférer les logs NGINX

Étendez votre configuration du collecteur pour inclure les logs d'accès et d'erreurs si vous souhaitez des événements de log en plus des métriques.

Notez les chemins complets de vos fichiers logs d'accès et d'erreurs NGINX. Les valeurs par défaut sont généralement /var/log/nginx/access.log et /var/log/nginx/error.log.

Mettez à jour /etc/nrdot-collector/nginx-plus-config.yaml pour ajouter un récepteur filelog et un pipeline de logs :

receivers:
  prometheus:
    # existing Prometheus receiver configuration
  filelog/nginx_access_logs:
    include:
      - /var/log/nginx/access.log
  filelog/nginx_error_logs:
    include:
      - /var/log/nginx/error.log

processors:
  batch:
    # existing settings
  filter/nginx_metrics:
    # existing settings
  resourcedetection:
    # existing settings
  resource/nginx:
    # existing settings
  transform/nginx_metrics:
    # existing settings
  transform/nginx_access_logs:
    log_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
          - set(attributes["logtype"], "nginx")
  transform/nginx_error_logs:
    log_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
          - set(attributes["logtype"], "nginx-error")

exporters:
  # existing exporter setup

service:
  pipelines:
    # Your existing metrics pipeline...

    # Add log pipelines
    logs/nginx-access:
      receivers: [filelog/nginx_access_logs]
      processors: [batch, resource/nginx, transform/nginx_access_logs]
      exporters: [otlp_http]
    logs/nginx-error:
      receivers: [filelog/nginx_error_logs]
      processors: [batch, resource/nginx, transform/nginx_error_logs]
      exporters: [otlp_http]

Accordez à l'utilisateur du collecteur l'accès en lecture aux fichiers de log :

bash

$sudo usermod -a -G adm nrdot-collector
$sudo chmod 644 /var/log/nginx/access.log
$sudo chmod 644 /var/log/nginx/error.log

Redémarrez le collecteur pour appliquer les modifications :
bash
```
$sudo systemctl restart nrdot-collector
```

Démarrer le monitoring

Maintenant que tout est configuré, démarrez le collecteur NRDOT et vérifiez que les données sont acheminées vers New Relic.

Appliquer les modifications de configuration :

bash

$sudo systemctl daemon-reload
$sudo systemctl restart nrdot-collector.service

Vérifiez que le service est en cours d'exécution :
bash
```
$sudo systemctl status nrdot-collector.service
```
Sortie attendue : Active: active (running) sans erreurs récentes

Vérifiez les logs de démarrage :

bash

$sudo journalctl -u nrdot-collector.service -n 20

Générez du trafic de test (pour créer des métriques) :

bash

$# Make a few requests to your NGINX Plus server
$curl http://localhost

Attendez que les données initiales apparaissent dans New Relic, puis accédez à votre dashboard NGINX pour vérifier la collecte des données.

Conseil

Si une étape de vérification échoue, installez les composants manquants avant de continuer. Besoin d'aide pour installer le collecteur ? Consultez le guide d’installation d’OpenTelemetry Collector.

Configurer le OpenTelemetry Collector

Configurez le collecteur OpenTelemetry pour extraire les métriques de votre exportateur Prometheus NGINX Plus et les envoyer à New Relic.

Important

Avant de modifier : sauvegardez votre configuration existante : sudo cp /etc/otelcol-contrib/config.yaml /etc/otelcol-contrib/config.yaml.backup

Modifiez votre fichier de configuration du collecteur (généralement /etc/otelcol-contrib/config.yaml) et ajoutez les sections suivantes. Si vous avez déjà des sections de récepteurs, de processeurs ou d'exportateurs, fusionnez-les avec votre configuration existante :

receivers:
  prometheus:
    config:
      scrape_configs:
        - job_name: 'nginx-plus'
          scrape_interval: 30s
          static_configs:
            - targets: ['<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>']
processors:
  batch:
    send_batch_size: 1024
    timeout: 30s
  filter/nginx_metrics:
    metrics:
      include:
        match_type: regexp
        metric_names:
          - "nginxplus_connections_.*"
          - "nginxplus_http_requests_.*"
          - "nginxplus_ssl_.*"
      exclude:
        match_type: regexp
        metric_names:
          - "nginxplus_server_.*"
          - "nginxplus_location_zone_.*"
          - "nginxplus_cache_.*"
          - "nginxplus_stream_server_.*"
          - "nginxplus_upstream_.*"
          - "nginxplus_stream_upstream_.*"
          - "nginxplus_stream_zone_sync_zone_.*"
          - "nginxplus_resolver_.*"
          - "nginxplus_limit_request_.*"
          - "nginxplus_limit_connection_.*"
          - "nginxplus_stream_limit_connection_.*"
          - "nginxplus_worker_.*"
  resource/nginx:
    attributes:
      - key: nginx.server.endpoint
        value: "<YOUR_API_STATUS_ENDPOINT>"  # Replace with your endpoint
        action: insert
      - key: nginx.deployment.name
        value: "<DEPLOYMENT_NAME>"                    # Replace with your deployment name
        action: insert
  resourcedetection:
    detectors: [system]
    system:
      resource_attributes:
        host.name:
          enabled: true
        host.id:
          enabled: true
  transform/nginx:
    metric_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
      - context: resource
        statements:
          - delete_key(attributes, "service.name")
  transform/metadata_nullify:
    metric_statements:
      - context: metric
        statements:
          - set(description, "")
          - set(unit, "")
exporters:
  otlp_http:
    endpoint: ${env:YOUR_NEWRELIC_OTLP_ENDPOINT}
    headers:
      api-key: ${env:YOUR_NEW_RELIC_LICENSE_KEY}
service:
  pipelines:
    metrics/nginx:
      receivers: [prometheus]
      processors: [batch, filter/nginx_metrics, resourcedetection, resource/nginx, transform/nginx, transform/metadata_nullify]
      exporters: [otlp_http]

Paramètres de configuration

Le tableau suivant décrit les principaux paramètres de configuration :

paramètres	Description
`<YOUR_PROMETHEUS_EXPORTER_ENDPOINT>`	Remplacez par le point de terminaison de l'exportateur Prometheus (par exemple « 127.0.0.1:9113 »)
`<YOUR_API_STATUS_ENDPOINT>`	Remplacez par le point de terminaison de statut de l'API du serveur NGINX Plus (par exemple http:/127.0.0.1/api/9)
`<DEPLOYMENT_NAME>`	Remplacez par un nom de déploiement unique pour ce serveur NGINX Plus (par exemple `production-web-01` , `staging-api` , `prod-lb-01` )
`scrape_interval`	Intervalle pour collecter les métriques. La valeur par défaut est définie sur `30s`
`send_batch_size`	Nombre de métriques à regrouper par lot avant l'envoi. La valeur par défaut est définie sur `1024`
`timeout`	Temps maximal d'attente avant l'envoi d'un batch. La valeur par défaut est définie sur `30s`
`nginx.display.name`	Format du nom d'affichage pour le serveur NGINX dans New Relic (généré automatiquement sous la forme "server: `<DEPLOYMENT_NAME>` ")

Par défaut, la configuration collecte uniquement les métriques de base (connexions, requêtes HTTP et SSL). Pour activer des catégories de métriques supplémentaires telles que les zones de serveur, les zones d'emplacement ou les métriques de cache :

Identifiez les métriques que vous souhaitez activer à partir de la liste des métriques ci-dessous. Notez la catégorie à laquelle ils appartiennent (par exemple, Zones de serveur HTTP, Zones de localisation, Cache).

Déplacez le préfixe de métrique correspondant de exclude à include dans le processeur filter/nginx_metrics.

Exemple : Activer les métriques HTTP Server Zones

Trouvez cette ligne dans la section exclude :

filter/nginx_metrics:
  metrics:
    include:
    # existing include metrics
    exclude:
      match_type: regexp
      metric_names:
        - "nginxplus_server_.*"

Déplacez-le dans la section include :

filter/nginx_metrics:
  metrics:
    include:
      match_type: regexp
      metric_names:
        - "nginxplus_connections_.*"
        - "nginxplus_http_requests_.*"
        - "nginxplus_ssl_.*"
        - "nginxplus_server_.*"  # Added to enable server zone metrics
    exclude:
      match_type: regexp
      metric_names:
        # Remove "nginxplus_server_.*" from here
        - "nginxplus_location_zone_.*"
        - "nginxplus_cache_.*"
        # ... rest of exclude list

Redémarrez le collecteur après avoir effectué des modifications :
bash
```
$sudo systemctl restart otelcol-contri.service
```

Configurer l'authentification

Configurez l'authentification sécurisée afin que l'OpenTelemetry Collector puisse envoyer des données à votre compte New Relic. Cette étape configure les variables d'environnement pour sécuriser vos informations d'identification.

Obtenez vos identifiants New Relic :
- Clé de licence : récupérez votre clé de licence à partir de la page de l'UI des clés API
- Point de terminaison OTLP : utilisez le point de terminaison de votre région parmi les points de terminaison OTLP New Relic

Configurez les identifiants :

Créer un répertoire de remplacement systemd :

bash

$export collector_distro="otelcol-contrib"
$sudo mkdir -p /etc/systemd/system/${collector_distro}.service.d

Créez le fichier de configuration de l'environnement :

bash

$cat <<EOF | sudo tee /etc/systemd/system/${collector_distro}.service.d/environment.conf
$[Service]
$Environment="NEWRELIC_OTLP_ENDPOINT=<`YOUR_NEWRELIC_OTLP_ENDPOINT>`"
$Environment="NEWRELIC_LICENSE_KEY=`<YOUR_NEW_RELIC_LICENSE_KEY>`"
$EOF

(Facultatif) Transférer les logs NGINX

Étendez votre configuration du collecteur pour inclure les logs d'accès et d'erreurs si vous souhaitez des événements de log en plus des métriques.

Notez les chemins complets de vos fichiers logs d'accès et d'erreurs NGINX. Les valeurs par défaut sont généralement /var/log/nginx/access.log et /var/log/nginx/error.log.

Mettez à jour /etc/otelcol-contrib/config.yaml pour ajouter un récepteur filelog et un pipeline de logs :

receivers:
  prometheus:
    # existing Prometheus receiver configuration
  filelog/nginx_access_logs:
    include:
      - /var/log/nginx/access.log
  filelog/nginx_error_logs:
    include:
      - /var/log/nginx/error.log

processors:
  batch:
    # existing settings
  filter/nginx_metrics:
    # existing settings
  resourcedetection:
    # existing settings
  resource/nginx:
    # existing settings
  transform/nginx_metrics:
    # existing settings
  transform/nginx_access_logs:
    log_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
          - set(attributes["logtype"], "nginx")
  transform/nginx_error_logs:
    log_statements:
      - context: resource
        statements:
          - set(attributes["nginx.display.name"], Concat(["server", attributes["nginx.deployment.name"]], ":"))
          - set(attributes["logtype"], "nginx-error")

exporters:
  # existing exporter setup

service:
  pipelines:
    # Your existing metrics pipeline...

    # Add log pipelines
    logs/nginx-access:
      receivers: [filelog/nginx_access_logs]
      processors: [batch, resource/nginx, transform/nginx_access_logs]
      exporters: [otlp_http]
    logs/nginx-error:
      receivers: [filelog/nginx_error_logs]
      processors: [batch, resource/nginx, transform/nginx_error_logs]
      exporters: [otlp_http]

Accorder l'accès en lecture au fichier log à l'utilisateur otelcol-contrib :

bash

$sudo usermod -a -G adm otelcol-contrib
$sudo chmod 644 /var/log/nginx/access.log
$sudo chmod 644 /var/log/nginx/error.log

Redémarrez le collecteur pour appliquer les modifications :
bash
```
$sudo systemctl restart otelcol-contrib
```

Démarrer le monitoring

Maintenant que tout est configuré, démarrez le collecteur OpenTelemetry et vérifiez que les données sont acheminées vers New Relic.

Appliquer les modifications de configuration :

bash

$sudo systemctl daemon-reload
$sudo systemctl restart otelcol-contrib.service

Vérifiez que le service est en cours d'exécution :
bash
```
$sudo systemctl status otelcol-contrib.service
```
Sortie attendue : Active: active (running) sans erreurs récentes

Vérifiez les logs de démarrage :

bash

$sudo journalctl -u otelcol-contrib.service -n 20

Générez du trafic de test (pour créer des métriques) :

bash

$# Make a few requests to your NGINX Plus server
$curl http://localhost

Attendez que les données initiales apparaissent dans New Relic, puis accédez à votre dashboard NGINX pour vérifier la collecte des données.

Rechercher et utiliser des données

Accédez à one.newrelic.com > Integrations & Agents.
Sélectionnez Dashboards, puis cliquez sur le dashboard NGINX OTel overview.
Dans la fenêtre contextuelle, sélectionnez votre compte.
Cliquez sur [View dashboard] et consultez vos données NGINX Plus dans New Relic.

Les métriques NGINX Plus sont attachées au type d'événement Metric. Vous pouvez interroger ces données à des fins de dépannage ou pour créer des graphiques et des dashboards personnalisés.

Métriques collectées

Le collecteur OpenTelemetry collecte les métriques à partir de l'exportateur NGINX Prometheus, qui expose les métriques de l'API HTTP NGINX Plus au format Prometheus.

Vous trouverez ci-dessous les métriques NGINX Plus disponibles :

métrique	Description	Type
`nginxplus_connections_accepted`	Connexions client acceptées	Somme
`nginxplus_connections_active`	Connexions clientes actives	Jauge
`nginxplus_connections_dropped`	Connexions client abandonnées	Somme
`nginxplus_connections_idle`	Connexions clientes inactives	Jauge

métrique	Description	Type
`nginxplus_http_requests_total`	Nombre total de requêtes http	Somme
`nginxplus_http_requests_current`	Requêtes http actuelles	Jauge

métrique	Description	Type
`nginxplus_ssl_handshakes`	Poignées de main SSL réussies	Somme
`nginxplus_ssl_handshakes_failed`	Échecs de poignées de main SSL	Somme
`nginxplus_ssl_session_reuses`	Réutilisations de session pendant la poignée de main SSL	Somme

Important

Remarque : ces métriques sont désactivées par défaut. Pour les activer, consultez (Facultatif) Activer les métriques supplémentaires pour le collecteur NRDOT ou (Facultatif) Activer les métriques supplémentaires pour OpenTelemetry Collector Contrib.

métrique	Description	Type
`nginxplus_server_zone_processing`	Requêtes client en cours de traitement	Jauge
`nginxplus_server_zone_requests`	Nombre total de requêtes client	Somme
`nginxplus_server_zone_responses`	Total des réponses envoyées aux clients	Somme
`nginxplus_server_zone_responses_codes`	Total des réponses envoyées aux clients par code	Somme
`nginxplus_server_zone_discarded`	Requêtes terminées sans envoyer de réponse	Somme
`nginxplus_server_zone_received`	Octets reçus des clients	Somme
`nginxplus_server_zone_sent`	Octets envoyés aux clients	Somme
`nginxplus_server_ssl_handshakes`	Poignées de main SSL réussies	Somme
`nginxplus_server_ssl_handshakes_failed`	Échecs de poignées de main SSL	Somme
`nginxplus_server_ssl_session_reuses`	Réutilisations de session pendant la poignée de main SSL	Somme

Important

métrique	Description	Type
`nginxplus_location_zone_requests`	Nombre total de requêtes client	Somme
`nginxplus_location_zone_responses`	Total des réponses envoyées aux clients	Somme
`nginxplus_location_zone_responses_codes`	Total des réponses envoyées aux clients par code	Somme
`nginxplus_location_zone_discarded`	Requêtes terminées sans envoyer de réponse	Somme
`nginxplus_location_zone_received`	Octets reçus des clients	Somme
`nginxplus_location_zone_sent`	Octets envoyés aux clients	Somme

Important

métrique	Description	Type
`nginxplus_cache_size`	Taille totale du cache	Jauge
`nginxplus_cache_max_size`	Taille maximale du cache	Jauge
`nginxplus_cache_cold`	Le cache est-il considéré comme froid	Jauge
`nginxplus_cache_hit_responses`	Nombre total de succès de cache	Somme
`nginxplus_cache_hit_bytes`	Nombre total d'octets renvoyés à partir des accès au cache	Somme
`nginxplus_cache_stale_responses`	Nombre total de succès de cache périmés	Somme
`nginxplus_cache_stale_bytes`	Nombre total d'octets renvoyés à partir des accès au cache périmé	Somme
`nginxplus_cache_updating_responses`	Nombre total de succès de cache pendant la mise à jour du cache	Somme
`nginxplus_cache_updating_bytes`	Nombre total d'octets renvoyés à partir du cache pendant la mise à jour du cache	Somme
`nginxplus_cache_revalidated_responses`	Nombre total de revalidations de cache	Somme
`nginxplus_cache_revalidated_bytes`	Nombre total d'octets renvoyés à partir des revalidations de cache	Somme
`nginxplus_cache_miss_responses`	Nombre total d'échecs de cache	Somme
`nginxplus_cache_miss_bytes`	Nombre total d'octets renvoyés à partir des échecs de cache	Somme
`nginxplus_cache_expired_responses`	Nombre total de hits de cache avec TTL expiré	Somme
`nginxplus_cache_expired_bytes`	Nombre total d'octets renvoyés à partir des succès de cache avec TTL expiré	Somme
`nginxplus_cache_expired_responses_written`	Nombre total de succès de cache avec TTL expiré écrit dans le cache	Somme
`nginxplus_cache_expired_bytes_written`	Nombre total d'octets écrits dans le cache à partir des succès de cache avec TTL expiré	Somme
`nginxplus_cache_bypass_responses`	Nombre total de contournements de cache	Somme
`nginxplus_cache_bypass_bytes`	Nombre total d'octets renvoyés à partir des contournements du cache	Somme
`nginxplus_cache_bypass_responses_written`	Nombre total de contournements de cache écrits dans le cache	Somme
`nginxplus_cache_bypass_bytes_written`	Nombre total d'octets écrits dans le cache à partir des contournements de cache	Somme

Attribut	Description	Exemples de valeurs
`server_zone`	Le nom de la zone du serveur (s'applique aux métriques des zones de serveur HTTP)	`example.com`, `api.example.com`
`code`	Code d'état de la réponse HTTP (s'applique aux métriques de réponse)	`1xx`, `2xx`, `3xx`, `4xx`, `5xx`, `200`, `404`, `500`
`location_zone`	Le nom de la zone de localisation	`/api`, `/images`, `/static`
`cache`	Le nom du cache	`my_cache`, `static_cache`
`nginx.server.endpoint`	L'URL du point de terminaison de l'API NGINX Plus	`http://localhost:8080/api`
`nginx.deployment.name`	Un nom unique pour identifier ce déploiement NGINX Plus	`production-web-01`, `staging-api`
`nginx.display.name`	Un nom convivial combinant le préfixe « server » avec le nom du déploiement	`server:production-web-01`
`host.name`	Le nom d'hôte du système sur lequel NGINX Plus est en cours d'exécution	`web-server-01.example.com`
`host.id`	L'identifiant unique du système hôte	`i-1234567890abcdef0`
`logtype`	Le type de log collecté (applicable aux logs uniquement). Utilisé par les règles d’analyse intégrées de New Relic. Cet attribut est disponible uniquement lorsque le transfert des logs est activé.	`nginx` (pour les logs d'accès), `nginx-error` (pour les logs d'erreurs)

Prochaines étapes

En savoir plus sur vos données :

Rechercher et interroger vos données NGINX - Accéder aux dashboards, créer des requêtes personnalisées et configurer des alertes
Introduction à NRQL - Apprenez le langage de requête de New Relic pour l'analyse avancée des données
Créer des conditions d'alerte NRQL - Configurer des alertes personnalisées basées sur vos métriques NGINX Plus

Explorer le monitoring connexe :

Monitorer NGINX auto-hébergé avec OpenTelemetry - Pour les déploiements NGINX standard
Monitorer NGINX sur Kubernetes avec OpenTelemetry - Pour les environnements conteneurisés

Cette traduction automatique est fournie pour votre commodité.

Monitorer NGINX Plus auto-hébergé avec OpenTelemetry

Avant de commencer .css-21sua1{background:none;border:none;width:0;padding:0;}

Configurer le monitoring de NGINX Plus

Conseil

Configurer le collecteur NRDOT

Étape 2 : (facultatif) activer les métriques supplémentaires

Configurer l'environnement et mettre à jour le chemin de configuration

Important

(Facultatif) Transférer les logs NGINX

Étape 1 : Configurer le format de log NGINX Plus

Étape 2 : configurer le collecteur NRDOT pour le transfert de logs

Démarrer le monitoring

Étape 1 : démarrer le collecteur

Étape 2 : Vérifier la collecte de données

Conseil

Configurer le OpenTelemetry Collector

Étape 1 : configurer la configuration du collecteur

Étape 2 : (facultatif) activer les métriques supplémentaires

Configurer l'authentification

(Facultatif) Transférer les logs NGINX

Étape 1 : Configurer le format de log NGINX Plus

Étape 2 : configurer le Collector OpenTelemetry pour le transfert de logs

Démarrer le monitoring

Étape 1 : démarrer le collecteur

Étape 2 : Vérifier la collecte de données

Rechercher et utiliser des données

Métriques collectées

Connexions

HTTP

SSL

Zones de serveur HTTP

Zones de localisation

Cache

Attributs

Prochaines étapes

Avant de commencer