HTTP 🔗

The Splunk Distribution of the OpenTelemetry Collector uses the Smart Agent receiver with the http monitor type to generate metrics based on whether the HTTP response from the configured URL matches expectations. For example, correct body, status code, and so on.

注釈

ネイティブのOpenTelemetry コンポーネントを使用してOpenTelemetry CollectorでHTTPエンドポイントを監視するには、HTTP check receiver を参照してください。

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

メリット 🔗

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

メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示するを参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用するを参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、Search the Metric Finder and Metadata Catalog を参照してください。

セットアップ 🔗

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 など。

インストール 🔗

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

Splunk Distribution of the OpenTelemetry Collector をホストまたはコンテナプラットフォームにデプロイします：
[設定] セクションの説明に従ってインテグレーションを設定します。
Splunk Distribution of OpenTelemetry Collector を再起動します。

設定 🔗

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

Smart Agent レシーバーを設定ファイルに含めます。
レシーバーセクションおよびパイプラインセクションの両方で、Collector 構成にモニタータイプを追加します。

Collector でSmart Agent モニターを使用するの方法を参照してください。
Smart Agent レシーバーの設定方法を参照してください。
一般的な設定オプションのリストについては、モニターの共通設定を参照してください。
Collectorの詳細は、はじめに：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をご利用のお客様

Submit a case in the Splunk Support Portal .
Contact Splunk Support .

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

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

このページは 2024年12月09日に最終更新されました。

Related Topics