概要
Agent の Kong チェックは、合計リクエスト数、応答コード数、クライアント接続数などを追跡します。
また、Kong の Datadog プラグインを使用すると、DogStatsD を使用して Datadog Agent を通じて Datadog に API、接続、データベースメトリクスを送信することができます。詳しくは、Datadog インテグレーションによる Kong の監視のブログ投稿をお読みください。
セットアップ
インストール
Kong チェックは Datadog Agent パッケージに含まれています。Kong サーバーに追加でインストールする必要はありません。
構成
ホスト
ホストで実行中の Agent に対してこのチェックを構成するには
メトリクスの収集
Prometheus プラグインを有効にすることで、OpenMetrics のメトリクスが Kong サービスで公開されることを確認します。これは、Agent が Kong のメトリクスを収集する前に、最初に構成する必要があります。
Kong メトリクスの収集を開始するには、Agent の構成ディレクトリのルートにある conf.d/
フォルダーの kong.d/conf.yaml
ファイルにこの構成ブロックを追加します。使用可能なすべての構成オプションについては、サンプル kong.d/conf.yaml を参照してください。
init_config:
instances:
## @param openmetrics_endpoint - 文字列 - 必須
## OpenMetrics 形式のメトリクスを公開するURL。
#
- openmetrics_endpoint: http://localhost:8001/metrics
Agent を再起動します。
注: 現在のバージョンのチェック (1.17.0+) は、メトリクスの収集に OpenMetrics を使用しており、これは Python 3 を必要とします。Python 3 を使用できないホスト、またはこのチェックのレガシーバージョンを使用する場合は、次の構成を参照してください。
ログ収集
Agent バージョン 6.0 以降で利用可能
Kong アクセスログは NGINX によって生成されます。したがって、デフォルトの場所は NGINX ファイルと同じです。
Datadog Agent で、ログの収集はデフォルトで無効になっています。以下のように、datadog.yaml
ファイルでこれを有効にします。
Kong のログの収集を開始するには、次の構成ブロックを kong.d/conf.yaml
ファイルに追加します。
logs:
- type: file
path: /var/log/nginx/access.log
service: '<SERVICE>'
source: kong
- type: file
path: /var/log/nginx/error.log
service: '<SERVICE>'
source: kong
path
パラメーターと service
パラメーターの値を変更し、環境に合わせて構成してください。使用可能なすべての構成オプションの詳細については、サンプル kong.d/conf.yaml を参照してください。
Agent を再起動します。
コンテナ化
Prometheus プラグインを有効にすることで、OpenMetrics のメトリクスが Kong サービスで公開されることを確認します。これは、Agent が Kong のメトリクスを収集する前に、最初に構成する必要があります。
コンテナ環境では、オートディスカバリーインテグレーションテンプレートを参照して、以下のパラメーターを適用するためのガイダンスを確認してください。
メトリクスの収集
パラメーター | 値 |
---|
<INTEGRATION_NAME> | kong |
<INIT_CONFIG> | 空白または {} |
<INSTANCE_CONFIG> | {"openmetrics_endpoint": "http://%%host%%:8001/metrics"} |
ログ収集
Agent バージョン 6.0 以降で利用可能
Datadog Agent で、ログの収集はデフォルトで無効になっています。有効にする方法については、Kubernetes ログ収集のドキュメントを参照してください。
パラメーター | 値 |
---|
<LOG_CONFIG> | {"source": "kong", "service": "<サービス名>"} |
検証
Agent の status サブコマンドを実行し、Checks セクションで kong
を探します。
収集データ
メトリクス
イベント
Kong チェックには、イベントは含まれません。
サービスチェック
kong.can_connect
Agent が Kong インスタンスに接続できない場合は、CRITICAL
を返します。それ以外の場合は、OK
を返します。
Statuses: ok, クリティカル
トラブルシューティング
ご不明な点は、Datadog のサポートチームまでお問合せください。
その他の参考資料