概要

このチェックでは、Datadog Agent を通じて Weaviate を監視します。詳細については、Weaviate モニタリングを参照してください。

計画と使用

ホストで実行されている Agent 用にこのチェックをインストールおよび構成する場合は、以下の手順に従ってください。コンテナ環境の場合は、オートディスカバリーのインテグレーションテンプレートのガイドを参照してこの手順を行ってください。

インフラストラクチャーリスト

Agent リリース 7.47.0 から、Weaviate チェックは Datadog Agent パッケージに含まれています。

注: この機能を使用するには、Agent v7.47.0 以上が必要です。

ブラウザトラブルシューティング

Weaviate は、Prometheus 形式のメトリクスを公開するように構成できます。Datadog Agent は、以下に説明するインテグレーションを使用して、これらのメトリクスを収集することができます。指示に従って、Weaviate インスタンスのデータ収集を構成してください。Prometheus メトリクスを公開するために必要な構成については、Weaviate ドキュメントの Monitoring ページを参照してください。

さらに、各種 API エンドポイントと通信することで、メトリクスの小さなサブセットを収集できます。具体的には

• /v1/meta: バージョン情報
• /v1/nodes: オブジェクトやシャードなどのノード固有のメトリクス
• /v1/.well-known/live: HTTP レスポンスタイムとサービスの有効性

注: このチェックでは、メトリクスの収集に OpenMetrics を使用しており、Python 3 が必要です。

コンテナ化

メトリクスの収集

Weaviate クラスターで Prometheus 形式のメトリクスが公開されていることを確認してください。Weaviate ドキュメントの Monitoring ページの指示に従って構成およびカスタマイズできます。Agent がメトリクスの収集を開始するには、Weaviate ポッドにアノテーションを付ける必要があります。アノテーションの詳細については、オートディスカバリーインテグレーションテンプレートを参照してください。その他の構成オプションについては、サンプル weaviate.d/conf.yaml を参照してください。

注: リストされたメトリクスは、利用可能な場合にのみ収集できます。一部のメトリクスは、特定のアクションが実行されたときにのみ生成されます。例えば、オブジェクト削除メトリクスは、オブジェクトが削除されたときにのみ公開されます。

Weaviate チェックの構成で最も重要なパラメーターは以下の 2 つです。

• openmetrics_endpoint: このパラメーターは、Prometheus 形式のメトリクスが公開される場所に設定する必要があります。デフォルトのポートは 2112 ですが、PROMETHEUS_MONITORING_PORT 環境変数を使用して構成することができます。コンテナ環境では、%%host%% をホストの自動検出に使用します。
• weaviate_api_endpoint: このパラメーターはオプションです。デフォルトでは、このパラメーターは <hostname>:8080 に設定され、RESTful API の構成を指定します。

RESTful API エンドポイントに認証が必要な場合、リクエストヘッダーの一部として API キーを提供するようにチェックを構成できます。

apiVersion: v1
kind: Pod
# (...)
metadata:
  name: '<POD_NAME>'
  annotations:
    ad.datadoghq.com/weaviate.checks: |
      {
        "weaviate": {
          "init_config": {},
          "instances": [
            {
              "openmetrics_endpoint": "http://%%host%%:2112/metrics",
              "weaviate_api_endpoint": "http://%%host%%:8080",
              "headers": {'Authorization': 'Bearer if_needed_for_auth'}
            }
          ]
        }
      }      
    # (...)
spec:
  containers:
    - name: 'weaviate'
# (...)

注: アノテーションは annotations キーを使用して、Weaviate Helm チャートに直接設定することができます。

検証

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

リアルユーザーモニタリング

データセキュリティ

ヘルプ

Weaviate インテグレーションには、イベントは含まれません。

ヘルプ

weaviate.openmetrics.health
Returns CRITICAL if the Agent is unable to connect to the Weaviate OpenMetrics endpoint, otherwise returns OK.
Statuses: ok, critical

weaviate.node.status
Returns CRITICAL if the node is UNAVAILABLE, WARNING if UNHEALTHY and OK if HEALTHY.
Statuses: ok, warning, critical

weaviate.liveness.status
Returns OK if liveness endpoint returns a 200 response, otherwise returns CRITICAL.
Statuses: ok, critical

ヘルプ

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