Docs » Splunk Observability Cloud でサポートされているインテグレーション » クラウドプラットフォーム用のアプリケーション・レシーバーの設定 » Heroku

Heroku 🔗

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

  • Splunk APM は sapm エクスポーターを使用します。otlphttp エクスポーターはカスタム設定で使用できます。

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

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

インストール 🔗

前提条件 🔗

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

インストール手順 🔗

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

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

    cd <HEROKU_APP_DIRECTORY>
    

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

  2. これは、Splunk OpenTelemetry Connector が app_nameapp_iddyno_id などのグローバルディメンションを設定するために必要です。詳細はこちらを参照してください。

    heroku labs:enable runtime-dyno-metadata
    
  3. 以下の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>
    
  4. 必要な環境変数を設定します。

    heroku config:set SPLUNK_ACCESS_TOKEN=<YOUR_ACCESS_TOKEN>
    heroku config:set SPLUNK_REALM=<YOUR_REALM>
    
  5. (オプション)Herokuプロジェクトディレクトリにカスタム設定ファイルを定義します。

    heroku config:set SPLUNK_CONFIG=/app/mydir/myconfig.yaml
    
  6. 既存のプロジェクトにbuildpackを追加するには、アプリをデプロイする前に空のコミットを作成する必要があります。

    git commit --allow-empty -m "empty commit"
    
  7. 以下のコマンドを実行してアプリをデプロイします。

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

    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。

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

Splunk Observability Cloudをご利用のお客様で、Splunk Observability Cloudでデータを確認できない場合は、以下の方法でサポートを受けることができます。

Splunk Observability Cloudをご利用のお客様

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

  • Splunk Answers のコミュニティサポートで質問し、回答を得る

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

This page was last updated on 2024年05月29日.