Cloud Foundry Loggregator Firehose

Cloud Foundry Loggregator Firehose モニターには、この Splunk Observability Cloud インテグレーションを使用してください。メリット、インストール、設定、メトリクスを参照してください

Splunk Distribution of OpenTelemetry Collectorは、Smart Agentレシーバー とCloud Foundry Loggregator Firehoseモニタータイプを使用して、Cloud Foundry Firehoseノズルを作成します。これは、Loggregatorからメトリクスを抽出するCloud Foundry Reverse Log Proxy (RLP) Gatewayに接続します。

注: ネイティブの OpenTelemetry コンポーネントを使用して OpenTelemetry Collector で Cloud Foundry を監視するには、「Cloud Foundry レシーバー」コンポーネントを参照してください。

以下が該当します：

  • このインテグレーションはLinuxのみで利用できます。

  • このインテグレーションは、Pivotal Cloud Foundry（PCF）バージョン 2.4 以降の RLP Gateway モデルを使用しているため、古いリリースでは動作しません。

  • モニターは、ゲージとカウンタメトリクスをサポートします。詳しくは「 メトリクスタイプ」を参照してください。

メリット

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

インストール

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

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

  2. 設定のセクションで説明するように、モニターを設定します。

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

設定

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

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

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

例

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

receivers:
  smartagent/cloudfoundry-firehose-nozzle
    type: cloudfoundry-firehose-nozzle
    ... # Additional config

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

service:
  pipelines:
    metrics:
      receivers: [smartagent/cloudfoundry-firehose-nozzle]

コンフィギュレーション設定

次の表に、このインテグレーションの設定オプションを示します：

オプション

必須

タイプ

説明

rlpGatewayUrl

いいえ

string

RLP Gateway サーバーへのベース URL。多くの場合

https://log-stream.<CLOUD CONTROLLER SYSTEM DOMAIN> 形式になります (PCF 2.4+を使用している場合)。

rlpGatewaySkipVerify

いいえ

bool

SSL/TLS検証をスキップするかどうか (HTTPS を使用して

RLP Gateway に接続する場合）（デフォルト：false）

uaaUser

いいえ

string

適切な権限を持ち

Firehose からログを取得するユーザーのUAAユーザー名 （通常は logs.admin 権限）。

uaaPassword

いいえ

string

上記UAAユーザーのパスワード

uaaUrl

いいえ

string

UAA サーバーの URL。このモニターはアクセストークンを

RLPゲートウェイとの認証に使用する、このサーバーから取得します。

uaaSkipVerify

いいえ

bool

SSL/TLS検証をスキップするかどうか (HTTPS を使用して

UAA サーバーに接続する場合）（デフォルト：false）。

shardId

いいえ

string

ノズルのシャード ID。同じ ID を持つすべてのノズルインスタンスは

Firehose からデータの排他的なサブセットを受信します。ほとんどの使用例ではデフォルトで十分です。（デフォルト： signalfx_nozzle）

PCFコンフィギュレーション

PCF の重要パフォーマンスインジケータ（KPI）のほとんどが Firehose を経由します。クラスターをスケールアップまたはスケールダウンするタイミングを決定するための KPI の詳細については、PCF のドキュメントを参照してください。

RLP Gatewayにアクセスするための適切な権限を持つCloud Foundry User Account and Authentication（UAA）ユーザーを作成するには、次のコマンドを実行します：

$ uaac client add my-v2-nozzle \
    --name signalfx-nozzle \
    --secret <signalfx-nozzle client secret> \
    --authorized_grant_types client_credentials,refresh_token \
    --authorities logs.admin

uaaUsername コンフィグ値を signalfx-nozzle に、uaaPassword フィールドを選択した <signalfx-nozzle client secret> に設定します。

メトリクス

ゲージとカウンターのメトリクスは、以下の方法でPCFプラットフォームアプリとプラットフォームコンポーネントから収集されます：

  • Firehose ゲージのメトリクスは Splunk Infrastructure Monitoring ゲージに変換されます。

  • Firehose カウンター・メトリクスは、Infrastructure Monitoring 累積カウンター・メトリクスに変換されます。

  • Firehose エンベロープのタグはすべて、Infrastructure Monitoring に送信する際にディメンションに変換されます。

このインテグレーションでは、以下のメトリクスを使用できます：

https://raw.githubusercontent.com/signalfx/splunk-otel-collector/main/internal/signalfx-agent/pkg/monitors/cloudfoundry/metadata.yaml

備考

  • Splunk Observability Cloud で利用可能なメトリクスタイプの詳細は、「メトリクスタイプ」を参照してください。

  • ホストベースのサブスクリプションプランでは、デフォルトのメトリクスは、ホスト、コンテナ、バンドルメトリクスなど、Splunk Observability Cloud のホストベースのサブスクリプションに含まれるメトリクスです。カスタムメトリクスはデフォルトでは提供されていないため、料金が発生する場合があります。詳細については、「メトリクスカテゴリ」を参照してください。

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

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

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

__ ___ ___ _ ______ _____________ _____ ________ ___ ___ ___ ____ __ ___ ____ ____ __ ______ _____________ ______ ___ ___ ___ ____ __ ___ _________ _____

_________ __ ______ _____________ _____ _________

_________ __ ___________ _________ ___ ____ _____ _____

  • ___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________

  • ____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______