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を使用してメトリクスを収集します：

コマンドラインインターフェイスで、Herokuプロジェクトディレクトリに移動します。
```
cd <HEROKU_APP_DIRECTORY>
```
注: プロジェクトディレクトリの外で herokuコマンドを実行すると、予期しない動作が起こります。
Dyno メタデータを公開するよう Heroku アプリケーションを設定してください。Dyno メタデータは、Splunk OpenTelemetry Connector が app_name、app_id、dyno_idなどのグローバルディメンションを設定するために必要です。詳細については、ここを参照してください。
```
heroku labs:enable runtime-dyno-metadata
```

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

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)

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

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

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

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

(オプション）Herokuプロジェクトディレクトリにカスタム設定ファイルを定義します。
```
heroku config:set SPLUNK_CONFIG=/app/mydir/myconfig.yaml
```
既存のプロジェクトにbuildpackを追加するには、アプリをデプロイする前に空のコミットを作成する必要があります。
```
git commit --allow-empty -m "empty commit"
```
以下のコマンドを実行してアプリをデプロイします。
```
git push heroku main
```
以下のコマンドを実行してログを確認します。
```
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。

トラブルシューティング

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

_________ __ ______ _____________ _____ _________

______ _ ____ __ ___ ______ _______ _______
_______ ______ ________

_________ __ ___________ _________ ___ ____ _____ _____

___ _ ________ ___ ___ _______ _______ _________ _______ __ ______ ________
____ ___ ______ ______________ ____ _____ _____ _______ __ ___________ ____ __________ _________ ___ ______ _________ __________ __ _____ ___ ____ _______