Heroku

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

Splunk OpenTelemetry Connector for Heroku は、Splunk Distribution of the OpenTelemetry Collector 用のビルドパックです。このビルドパックは Dyno に Splunk OpenTelemetry Connector をインストールして実行し、Splunk Observability Cloud のメトリクスデータとトレースデータを受信、処理、エクスポートします。

  • otlphttp エクスポーターを介した Splunk APM。

    signalfx エクスポーターを介した Splunk Infrastructure Monitoring。

詳細については、「Splunk Distribution of the OpenTelemetry Collector の利用開始」を参照してください。

前提条件

Heroku ビルドパックをインストールしてメトリクスを収集する前に、Heroku アプリをインストールする必要があります。Heroku CLI をインストールしてアプリを作成する方法については、開発者向けの Heroku ドキュメントを参照してください。

インストール手順

以下の手順に従って、Splunk Distribution of OpenTelemetry Collector用Heroku buildpackを使用してメトリクスを収集します：

  1. コマンドラインインターフェイスで、Herokuプロジェクトディレクトリに移動します。

    BASH 
    cd <HEROKU_APP_DIRECTORY>
    注: プロジェクトディレクトリの外で herokuコマンドを実行すると、予期しない動作が起こります。

  2. Dyno メタデータを公開するよう Heroku アプリケーションを設定してください。Dyno メタデータは、Splunk OpenTelemetry Connector が app_name、app_id、dyno_idなどのグローバルディメンションを設定するために必要です。詳細については、ここを参照してください。

    BASH 
    heroku labs:enable runtime-dyno-metadata

  3. 以下の2つのコマンドを一緒に実行して、Heroku buildpackを追加します。

    BASH 
    heroku buildpacks:add https://github.com/signalfx/splunk-otel-collector-heroku.git#\
$(curl -s https://api.github.com/repos/signalfx/splunk-otel-collector-heroku/releases | grep '"tag_name"' | head -n 1 | cut -d'"' -f4)

    実稼働環境で明確なバージョン番号を使用したい場合は、最初のコマンドを以下のコマンドに置き換えてください。

    BASH 
    heroku buildpacks:add https://github.com/signalfx/splunk-otel-collector-heroku.git#<TAG_NAME>

  4. 必要な環境変数を設定します。

    BASH 
    heroku config:set SPLUNK_ACCESS_TOKEN=<YOUR_ACCESS_TOKEN>
heroku config:set SPLUNK_REALM=<YOUR_REALM>

  5. (オプション）Herokuプロジェクトディレクトリにカスタム設定ファイルを定義します。

    BASH 
    heroku config:set SPLUNK_CONFIG=/app/mydir/myconfig.yaml

  6. 既存のプロジェクトにbuildpackを追加するには、アプリをデプロイする前に空のコミットを作成する必要があります。

    BASH 
    git commit --allow-empty -m "empty commit"

  7. 以下のコマンドを実行してアプリをデプロイします。

    BASH 
    git push heroku main

  8. 以下のコマンドを実行してログを確認します。

    BASH 
    heroku logs -a <app-name> --tail

設定

以下の環境変数を使用して、Heroku buildpackを設定します。

環境変数

必須

デフォルト

説明

SPLUNK_ACCESS_TOKEN

あり

Splunk アクセストークン。

SPLUNK_REALM

あり

Splunk レルム

SPLUNK_API_URL

いいえ

https://api.SPLUNK_REALM.signalfx.com

Splunk API のベース URL。

SPLUNK_CONFIG

いいえ

/app/config.yaml

 使用する設定。/app/.splunk/config.yaml は

デフォルトが見つからない場合に使用されます。

SPLUNK_INGEST_URL

いいえ

https://ingest.SPLUNK_REALM.signalfx.com

Splunk Infrastructure Monitoring のベース URL。

SPLUNK_LOG_FILE

いいえ

/dev/stdout

 エージェントログの場所を指定します。指定しない場合、ログは

標準出力に送られます。

SPLUNK_MEMORY_TOTAL_MIB

いいえ

512

エージェントが使用可能なメモリの合計。

SPLUNK_OTEL_VERSION

いいえ

latest

使用する Splunk OTel Connector のバージョン。デフォルトは最新です。

SPLUNK_TRACE_URL

いいえ

https://ingest.SPLUNK_REALM.signalfx.com/v2/trace

Splunk APM のベース URL。

トラブルシューティング

If you are a Splunk Observability Cloud customer and are not able to see your data in Splunk Observability Cloud, you can get help in the following ways.

Available to Splunk Observability Cloud customers

Available to prospective customers and free trial users

  • Ask a question and get answers through community support at Splunk Answers.

  • Join the Splunk community #observability Slack channel to communicate with customers, partners, and Splunk employees worldwide.