この記事は日本語ではご利用いただけません。下記は英語版のオリジナルです。

言語ランタイムメトリクス

最終更新日 2024年12月03日(火)

メモリのヘルスに関する追加の洞察を提供するために、オプションで言語固有のランタイムメトリクスを提供しています。JVM​、Go​ (パブリックベータ)、Node.js​ (パブリックベータ)、および Ruby​ (パブリックベータ) が現時点でサポートされています。

この機能は Fir​ 世代のアプリではまだ利用できません。この機能が Fir に追加されたときに通知を受け取るには、Changelog​ の受信登録を行ってください。

一般的な情報

すべてのメトリクスの単位は選択したタイムフレームに依存します。メトリクスの保持および単位についての詳細は、アプリケーション関連のメトリクスのドキュメント​を参照してください。

言語ランタイムメトリクスは、eco​ dyno を除いた、サポートされている言語を使用するすべての dyno で利用できます。

設定手順

まず、アプリケーションで 「Language Metrics」 (言語メトリクス) フラグを有効にします。これは、ダッシュボードまたは CLI を使用して実行できます。これをダッシュボードから有効にするには、メトリクスの環境設定パネルを開き、「Enhanced Language Metrics」 (拡張言語メトリクス) トグルを有効にします。

languageMetricsToggle

Heroku CLI から有効にするには、次のようにします。

$ heroku labs:enable "runtime-heroku-metrics" -a "my-app-name"

このトグルは、アプリケーションによってエクスポートされている言語固有のメトリクスをすべて収集して報告するよう、メトリクス収集バックエンドに通知します。言語によっては、これらのメトリクスをデータ収集サービスにエクスポートするために、いくつか追加の手順を実行することが必要な場合があります。

メトリクスのエクスポートの詳しい手順と、利用可能なメトリクスについての詳細は、言語固有のドキュメントを参照してください。

パイプラインでの使用

Heroku パイプラインで言語ランタイムメトリクスを使用するには、パイプラインの最も下流に位置するアプリ (プロモートする前にデプロイするアプリ) で設定手順に従う必要があります。その後、プロモートする前に、パイプラインの上流に位置するすべてのアプリのメトリクスダッシュボードで機能を有効にする必要があります。

ダウンストリームアプリが Eco 層のアプリである場合は、メトリクスダッシュボードでの機能の有効化を除くすべての設定手順に従う必要があります (たとえば、buildpack または新しい依存関係をアプリに引き続き追加する必要があります)。この機能は Eco アプリでは動作しませんが、プロモートすれば、下流の他のすべての dyno タイプで機能を使用できるようになります。

サンプルメトリクス

jvmmetrics1

goMetrics

メトリクス収集の無効化

何らかの理由で追加言語のデータ収集を中止する場合は、「Metrics Preferences」 (メトリクスの環境設定) パネルから、または次の CLI コマンドを使用して 「Enhanced Language Metrics」 (詳細な言語関連のメトリクス) トグルをオフにします。

$ heroku labs:disable "runtime-heroku-metrics" -a "my-app-name"

このフラグを無効にしている期間中はメトリクスデータの欠落が生じることに注意してください。