概要

このチェックでは、Kubernetes の NGINX Ingress Controller を監視します。F5 NGINX Ingress Controller を監視するには、NGINX Prometheus Exporter が提供するリストから目的のメトリクスを監視するように Datadog Prometheus インテグレーションをセットアップしてください。

セットアップ

インストール

nginx-ingress-controller チェックは Datadog Agent パッケージに含まれているため、サーバーに追加でインストールする必要はありません。

構成

メトリクスの収集

デフォルトでは、NGINX のメトリクスは nginx-ingress-controller チェックによって収集されますが、Ingress Controller に対して標準の nginx チェックを実行できると便利な場合があります。

これは、Agent から NGINX のステータスページに到達できるようにすることで実現できます。それには、コントローラーで nginx-status-ipv4-whitelist 設定を使用し、コントローラーポッドにオートディスカバリーアノテーションを追加します。

たとえば、以下のアノテーションは、nginx および nginx-ingress-controller のチェックとログ収集を共に有効にします。

使用可能なすべての構成オプションの詳細については、sample nginx_ingress_controller.d/conf.yaml を参照してください。

注: nginx-ingress-controller の 0.23.0 以降のバージョンでは、ポート18080 でリッスンしている nginx サーバーは削除されました。構成 ConfigMap に次の http-snippet を追加することで復元できます。

  http-snippet: |
    server {
      listen 18080;

      location /nginx_status {
        allow all;
        stub_status on;
      }

      location / {
        return 404;
      }
    }

ログ収集

Agent バージョン 6.0 以降で利用可能

Datadog Agent で、ログの収集はデフォルトで無効になっています。有効にする方法については、Kubernetes ログ収集を参照してください。

検証

Agent の status サブコマンドを実行し、Checks セクションで nginx_ingress_controller を探します。

収集データ

メトリクス

イベント

NGINX Ingress Controller には、イベントは含まれません。

サービスチェック

NGINX Ingress Controller には、サービスのチェック機能は含まれません。

トラブルシューティング

ご不明な点は、Datadog のサポートチームまでお問合せください。