カスタムメトリックの使用方法

カスタム指標によるより深い洞察

AppSignal gemを使用すると、カスタムインストルメンテーションを使用して、アプリケーションのパフォーマンスに関する詳細を取得できます。ただし、他の指標も追跡したい場合があります。

1.0を使用 gemのリリースでは、カスタムメトリックをAppSignalに送信できます。これらのメトリックを使用すると、新しいアカウントからデータベースディスクの使用状況まで、アプリケーション内のあらゆるものを追跡できます。これらはコードインストルメンテーションに代わるものではありませんが、コード内の特定のデータにアクセスしやすく、時間の経過とともに測定できるようにするための追加の方法です。

次の3種類の指標を提供しています。

AppSignal gemには、これらのメトリックタイプごとにメソッドがあります。これらのメソッドを使用して、システムにデータを送信できます。

ゲージ

ゲージは、増加と減少の両方が可能なメトリックに最適です。 AppSignalのゲージを使用して、アクティブなアカウントの数をグラフ化します。

count = Account.active.count
Appsignal.set_gauge('account_count', count)

カウンター

名前が示すように、カウンターは、何かが発生した回数を追跡するための優れた方法です。私たちの労働者は、複数のデータポイントを含むペイロードを処理します。これは、ジョブの数が、処理するデータの量を正確に表していないことを意味します。カウンターを使用して、処理するデータポイントごとにインクリメントします。

minute.metrics.each do |metric|
  Appsignal.increment_counter('metric_count', metric.length)
end

配布

分布を使用して、コードの実行にかかる平均時間を測定します。たとえば、ジョブは複数のmap / reduceジョブを実行でき、インストルメンテーションを使用して期間を追跡している場合でも、各ジョブの平均期間を確認する必要があります。素敵なグラフ。

Appsignal.add_distribution_value('mapreduce_duration', MapReduce::Minutely.new.run.time)

指標をグラフに変換する

AppSignalにメトリックを送信することは、話の半分にすぎません。データを送信した後、メトリックを表示するグラフを作成する必要があります。これは、「カスタム指標」ページのエディタで行います。

カスタムメトリック機能を使用すると、グラフを使用して複数の画面を作成できます。 YAML形式で画面とこれらの画面のグラフを定義できます。

たとえば、アカウントが解放されたグラフを含む画面を作成し、アカウントの数を示すグラフを表示するには、次のYAMLを使用できます。

- title: Account overview
  graphs:
    - title: "Number of accounts"
      kind: gauge
      format: number
      fields:
        - account_count

これにより、次のページが表示されます：

フィールドを含むリストの代わりに、1つ以上のメトリック名に一致する正規表現を提供することもできます。以下の例では、サードパーティAPIの各API応答コードの線を含むグラフをレンダリングしています。

- title: API Responses
  graphs:
    - title: "API response codes"
      kind: count
      filter: "api_response_code_[0-9]+"
      format: number

これらは、AppSignalで追跡できる多くの有用なメトリックのほんの一部です。カスタム指標の詳細については、ドキュメントを確認するか、アカウントでこれを設定するためのサポートが必要な場合はお問い合わせください。