Docs » Splunk Observability Cloud でサポートされているインテグレーション » ホストとサーバーのアプリケーション・レシーバーの設定 » HTTP

HTTP 🔗

Splunk Distribution of OpenTelemetry Collector は、Smart Agent レシーバー と http モニタータイプを使用し、設定された URL からの HTTP レスポンスが期待値と一致するかどうかに基づいてメトリクスを生成します。例えば、正しいボディ、ステータスコードなどです。

該当する場合、useHTTPS パラメータが設定されているかどうかに応じて、ベースURLまたはリダイレクトからTLS情報が自動的に取得されます。

メリット 🔗

インテグレーションを設定すると、これらの機能にアクセスできるようになります：

セットアップ 🔗

URLからウェブチェックを作成するには、URLをさまざまな構成オプションに分割します。これらのオプションはすべて、「正規化」されたURLからURLディメンション値を決定します。URLディメンション値は、{scheme}://{host}:{port}{path} の形式です：

  • scheme は、useHTTPS:true の場合は https 、useHTTPS:false の場合は http となります。

  • host はチェックするサイトのホスト名です。このオプションは必須です。

  • port は接続するポートです。定義されていない場合、 port は、useHTTPS:true の場合は 443 となり、useHTTPS:false の場合は 80 となります。http のデフォルト値は 80 です。デフォルト値を使用する場合、 port は暗黙的であり、curl と同様の動作になるため、設定から削除されます。

  • path には、リソースパスを含む完全なクエリが含まれ、最後に GET メソッド・パラメータが ? セパレータ付きで含まれます。

このURLで行われるリクエストの動作を変更するために、以下のオプションを設定します：

  • GET や POST のようなリクエストタイプを定義するために、method オプションを設定します。利用可能なメソッドの全リストは https://golang.org/src/net/http/method.go を参照してください。

  • 基本認証の username および password オプションを設定します。

  • リクエストヘッダーを定義するために httpHeaders オプションを設定します。host ヘッダーを上書きするにはこのオプションを使います。

  • リクエストにボディを提供するために requestBody オプションを設定します。このボディの形式は Content-Type ヘッダーに依存します。例えば、{"foo":"bar"} に Content-Type: application/json を指定します。

  • URL がリダイレクトをたどらないようにするには、noRedirects:false オプションを設定します。デフォルト値は true です。

異なるリクエストの動作については設定例を参照してください。

以下の設定オプションは、結果の値を変更します：

  • desiredCode オプションは http.code_matched の値を決定します。異なる 「normal 「値を期待する場合は、このオプションを設定します。デフォルト値は 200 。例えば、desiredCode:301 と noRedirects:false を設定し、リダイレクトをチェックする (リダイレクト先のURLではなく) ようにすると、値は 1 (成功) になります。

  • regex オプションは、http.regex_matched メトリクスと同じことをします。ここで値は、指定された正規表現がレスポンスボディにマッチする場合のみ、1 となります。

  • addRedirectURL オプションはメトリクスには影響しませんが、」dynamic」 値を持つ新しいディメンション redirect_url が追加されます。url ディメンションがモニター構成によって変更された場合、 redirect_url の値はサーバー変更によって影響を受け、常に最後にリダイレクトされた URL になります。このオプションは、ハートビート検出などで問題が発生する可能性があるため、デフォルトでは無効になっています。

以下のHTTPヘッダーは、クライアントとサーバーがHTTPリクエストまたはレスポンスで追加情報を受け渡しできるようにします：

  • Cache-Control: no-cache で、キャッシュされたコピーをリリースする前に、検証のためにリクエストをオリジンサーバーに送ることができます。

  • Host で、そのリクエストを変更、つまりCDNやロードバランサーをバイパスして、バックエンドに直接リクエストします。

  • Content-Type で、リソースのメディアタイプを示します。例えば、json 、xml 、octet-stream など。

インストール 🔗

このインテグレーションを導入するには、以下の手順に従ってください：

  1. Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：

  2. [設定] セクションの説明に従ってインテグレーションを設定します。

  3. Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

Smart Agent モニターとCollector のインテグレーションを使用するには、以下の手順に従います：

  1. Smart Agent レシーバーを設定ファイルに含めます。

  2. レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

例 🔗

このインテグレーションを有効にするには、Collector構成に以下を追加します：

receivers:
  smartagent/http:
    type: http
    ... # Additional config

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/http]

複数のホストを監視する 🔗

複数のホストをモニターするには、コンフィギュレーションの receivers セクションに各ホストの http モニターエントリーを追加します。例：

receivers:
  smartagent/host1:
    type: http
    ... # Additional config for host 1
  smartagent/host2:
    type: http
    ... # Additional config for host 2

次に、設定ファイルの service.pipelines.metrics.receivers セクションにモニターを追加します：

service:
  pipelines:
    metrics:
      receivers: [smartagent/host1, smartagent/host2]

設定オプション 🔗

次の表に、このモニターの設定オプションを示します：

オプション

必須

タイプ

説明

host

いいえ

string
監視するホストまたはIPアドレス。注：ホストは

機能に必要ですが、コンフィギュレーションの検証には必要ありません。

port

いいえ

integer
監視するHTTPサーバーのポート。デフォルト値は

0 です。

path

いいえ

string

テスト・リクエストで使用するHTTPパス。

httpTimeout

いいえ

int64
読み込みと書き込みの両方のHTTPタイムアウト時間。これは

ParseDuration タイプによって受け入れられる継続時間文字列です。デフォルト値は 10s です。

username

いいえ

string

各リクエストで使用する基本認証ユーザー名(ある場合)。

password

いいえ

string

各リクエストで使用する基本認証パスワード(ある場合)。

useHTTPS

いいえ

bool
true の場合、Collector は、プレーンHTTP の代わりに HTTPS を

使用してサーバーに接続します。デフォルト値は false です。

httpHeaders

いいえ

map of strings
HTTP ヘッダー名と値のマップ。カンマ区切りの複数

同じメッセージ・ヘッダーの値がサポートされています。

skipVerify

いいえ

bool
useHTTPS がtrueで、このオプションも true の場合、

エクスポーターのTLS証明書は検証されません。デフォルト値は false です。

sniServerName

いいえ

string
useHTTPS が true で、skipVerify が true の場合、

sniServerNameは、返された証明書のホスト名を検証するために使用されます。また、IPアドレスでない限り、バーチャルホスティングをサポートするためにクライアントのハンドシェイクにも含まれます。

caCertPath

いいえ

string
TLS証明書に署名したCA証明書へのパス。

skipVerify が false に設定されている場合、このオプションは不要です。

clientCertPath

いいえ

string
TLSが必要な接続に使用するクライアントTLS証明書への

パス。

clientKeyPath

いいえ

string
TLS必須に使用するクライアントTLSキーへのパス

パス。

requestBody

いいえ

string
オプションのHTTPリクエスト・ボディ、例えば、

{"foo":"bar"}。

noRedirects

いいえ

bool

リダイレクトに従いません。デフォルト値は false です。

method

いいえ

string

使用する HTTP リクエストメソッド。デフォルト値は GET です。

urls

いいえ

list of strings
監視するHTTP URLのリストを提供します。このオプションは

**非推奨**です。代わりに host / port / useHTTPS / path を使用してください。

regex

いいえ

string

URL(複数可)のレスポンスにマッチする正規表現(オプション)。

desiredCode

いいえ

integer
URL レスポンスに一致するコード。デフォルト値

は 200 です。

addRedirectURL

いいえ

bool
redirect_url ディメンションを追加します。 リダイレクトが実行される場合

url と異なるかもしれません。デフォルト値は false です。

メトリクス 🔗

これらは、このインテグレーションで利用可能なメトリクスです：

備考 🔗

  • To learn more about the available in Splunk Observability Cloud see メトリクスタイプ

  • In host-based subscription plans, default metrics are those metrics included in host-based subscriptions in Splunk Observability Cloud, such as host, container, or bundled metrics. Custom metrics are not provided by default and might be subject to charges. See メトリクスカテゴリ for more information.

  • MTSベースのサブスクリプションプランでは、すべてのメトリクスがカスタムです。

  • メトリクスを追加するには、その他のメトリクスの追加 で extraMetrics の設定方法を参照してください。

トラブルシューティング 🔗

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

見込み客および無料トライアルユーザー様

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

  • Splunk #observability ユーザーグループの Slack チャンネルに参加して、世界中の顧客、パートナー、Splunk 社員とのコミュニケーションを図る。参加するには、Get Started with Splunk Community マニュアルの チャットグループ を参照してください。

This page was last updated on 2024年05月29日.