This check monitors the kubernetes NGINX Ingress Controller.

The nginx-ingress-controller check is included in the Datadog Agent package, so you do not need to install anything else on your server.

1. Edit the nginx_ingress_controller.d/conf.yaml file, in the conf.d/ folder at the root of your Agent's configuration directory to start collecting your NGINX ingress controller metrics. See the sample nginx_ingress_controller.d/conf.yaml for all available configuration options.

2. Restart the Agent.

Available for Agent >6.0

• Collecting logs is disabled by default in the Datadog Agent. Enable it in your daemonset configuration:

(...)
  env:
    (...)
    - name: DD_LOGS_ENABLED
        value: "true"
    - name: DD_LOGS_CONFIG_CONTAINER_COLLECT_ALL
        value: "true"
(...)

• Make sure that the Docker socket is mounted to the Datadog Agent as done in this manifest.

• Restart the Agent.

By default, NGINX metrics are collected by the nginx-ingress-controller check, but for convenience you might want to run the regular nginx check on the ingress controller.

You can achieve this by making the NGINX status page reachable from the Agent. To do this, use the nginx-status-ipv4-whitelist setting on the controller and add Autodiscovery annotations to the controller pod.

For example these annotations, enable both the nginx and nginx-ingress-controller checks and the log collection:

ad.datadoghq.com/nginx-ingress-controller.check_names: '["nginx","nginx_ingress_controller"]'
ad.datadoghq.com/nginx-ingress-controller.init_configs: '[{},{}]'
ad.datadoghq.com/nginx-ingress-controller.instances: '[{"nginx_status_url": "http://%%host%%/nginx_status"},{"prometheus_url": "http://%%host%%:10254/metrics"}]'
ad.datadoghq.com/nginx-ingress-controller.logs: '[{"service": "controller", "source":"nginx-ingress-controller"}]'

Run the Agent's status subcommand and look for nginx_ingress_controller under the Checks section.

See metadata.csv for a list of metrics provided by this integration.

nginx-ingress-controller does not include any service checks.

nginx-ingress-controller does not include any events.

Need help? Contact Datadog support.