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.
注釈
To monitor HTTP endpoints with the OpenTelemetry Collector using native OpenTelemetry components refer to the HTTP check receiver.
該当する場合、useHTTPS
パラメータが設定されているかどうかに応じて、ベースURLまたはリダイレクトからTLS情報が自動的に取得されます。
メリット 🔗
インテグレーションを設定すると、これらの機能にアクセスできるようになります:
メトリクスを表示します。独自のカスタム・ダッシュボードを作成することができ、ほとんどのモニターは組み込みのダッシュボードも提供しています。ダッシュボードについては、Splunk Observability Cloudでダッシュボードを表示する を参照してください。
Infrastructure Monitoring に表示される環境内の物理サーバー、仮想マシン、AWS インスタンス、およびその他のリソースのデータ駆動型の視覚化を表示します。ナビゲーターについては、Splunk Infrastructure Monitoring でナビゲーターを使用する を参照してください。
Metric Finder にアクセスして、モニターから送信されたメトリクスを検索します。詳細については、メトリクス・ファインダーとメタデータ・カタログを検索する を参照してください。
セットアップ 🔗
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]
設定オプション 🔗
次の表に、このモニターの設定オプションを示します:
オプション |
必須 |
タイプ |
説明 |
---|---|---|---|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
テスト・リクエストで使用するHTTPパス。 |
|
いいえ |
|
|
|
いいえ |
|
各リクエストで使用する基本認証ユーザー名(ある場合)。 |
|
いいえ |
|
各リクエストで使用する基本認証パスワード(ある場合)。 |
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
|
|
いいえ |
|
リダイレクトに従いません。デフォルト値は |
|
いいえ |
|
使用する HTTP リクエストメソッド。デフォルト値は |
|
いいえ |
|
|
|
いいえ |
|
URL(複数可)のレスポンスにマッチする正規表現(オプション)。 |
|
いいえ |
|
|
|
いいえ |
|
|
メトリクス 🔗
これらは、このインテグレーションで利用可能なメトリクスです:
備考 🔗
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 マニュアルの チャットグループ を参照してください。