カスタム・コール・メトリクス（パブリック・プレビュー）
言語固有の Instana SDKを使用して手動で計測を行うことで、アプリケーションの呼び出しにカスタム呼び出しメトリクス（数値）を付与することができます。 Unboundedの分析ビューでこれらの通話メトリクスを使用すると、数値条件（より小さい、またはより大きい）に基づいて通話をフィルタリングできるほか、これらの値の経時的な集計値をグラフ化することもできます。
目的と使用例
カスタム通話メトリクスを使用すると、 Instana がデフォルトでは収集しない通話関連の数値データを分析することができます。 これらは、データ・サイズやタイミングなどの技術的な測定基準や、ショッピング・カート内の商品の合計金額などのビジネス関連の測定基準にも使用できます。 値は整数でなければならないので、適切なスケーリングが必要である。
カスタム・コール・メトリクスは、インスツルメンテッド・コード内のコールをカスタム・コール・タグでアノテートする既存のサポートを拡張するもので、ユーザー定義の文字列値に従ってコールをフィルタリングおよび分類することができる。 カスタム・メトリクスは数値であるため、フィルタリングやグルーピングに使用できるだけでなく、コール・グループの数値を集計することもできます。
以下のタスクでは、アンバインド分析ビューでコール・メトリクスを使用する方法の例をいくつか示します：
- 処理されたデータのサイズでコールに注釈を付け、そのサイズでフィルタリングして、そのサイズがある閾値を超えたコールを表示する。
- 同じデータサイズのアノテーションを使用して、コールの最大データサイズが経時的にどのように変化するかを表示する。
- Instana がデフォルトで記録する全体的なコール遅延に加え、特定の処理段階に関心がある場合は、コール内の各段階の所要時間を追跡してください。
- キャッシュヒットを'
100、キャッシュミスを'0として、呼によるキャッシュへのアクセスを追跡し、平均集計を使用して、呼のキャッシュヒット率のグラフを経時的に見る。
Instana へのカスタム通話メトリクスの送信
Instana にカスタム通話メトリクスを送信するには、以下の手順を実行してください：
- コールタグ用の文字列キーバリューデータでコールに注釈を付けるために使用されるのと同じトレースSDKメソッドを使用して、コード内のアプリケーションコールに注釈を付けます。
- 注釈を文字列のコールタグではなく、数値のコールメトリックとして保存したい場合は、キーに接頭辞「
metrics.使用する。 - 値が整数としてパースできることを確認する。 言語やSDKによっては、整数を直接渡すか、 API の定義に合わせて文字列に変換してください。
Java Trace SDK では、次の例に示すように、呼び出しにカスタム呼び出しメトリクスを付与することができます
SpanSupport.annotate("metrics.processingTime", String.valueOf(1234));
カスタム・コール・メトリクスの分析
コール・メトリクスは、以下のタスクに使用できます：
コール・メトリクスを使用した通話のフィルタリング
コール・メトリクスを使用してコールをフィルタリングするには、[Unbounded analytics] ビューで以下の手順を実行します：
- Instana のUIのサイドバーから、 「Analytics」 を選択します。
- Analyticsページで、Applications breadcrumb trailの矢印をクリックし、Callsを選択します。
- Add filterをクリックする。
- コール] > [カスタム・コール・メトリクス] を選択し、フィルタのメトリック・キー、値、および比較演算子を指定します。
t`a` processingtime > 1000 を指定したフィルタでは、 前の例で示したサンプル SDK アノテーション（キーとして ` processingTime a` を使用しているもの）との一致は得られません。通話に関するその他のフィルタと同様に、 アプリケーション・パースペクティブのフィルタ条件でも通話メトリクスを使用できます。
コールメトリクスを使用した通話のグループ化
コール・メトリクスは、アンバインド分析ビューのグループ化フィールドとして使用できます。 グループ数が多すぎるとクエリの実行パフォーマンスが低下する可能性があるため、アプリケーションから送信される値の範囲がせいぜい数百種類程度に限定されていることが分かっている場合にのみ、グループ化にコールメトリクスを使用すべきです。
カスタム・コール・メトリクスのチャート表示
また、コールのUnboundedアナリティクスでカスタムコールメトリクスのチャートを表示することもできます。 チャートを表示するには、以下の手順を実行する：
- Instana のUIのサイドバーから、 「Analytics」 を選択します。
- Analyticsページで、Applications breadcrumb trailの矢印をクリックし、Callsを選択します。
- Chart]ウィジェットで、リストから[Custom call metrics]を選択し、メトリック・キーと、各時間バケッ トのメトリックの結合に使用する集約を入力します。
パフォーマンスに関する注意
文字列形式のキー・バリュー注釈と同様に、使用するキーの数を制限し（最大でも数百個程度）、プロセスIDなど頻繁に変更される要素をキー 文字列に含めないようにしてください。 異なるキーを過度に使用すると、パフォーマンスが低下する可能性がある。
既知の制限
コール・メトリクスの以下の点は、完全にはサポートされていません：
- コール・メトリクスはカスタム・ダッシュボードでは使用できません。 コール・メトリクスは、アンバインド分析ビューでのみグラフ化できます。
- Unbounded Analyticsビューでのコール・メトリクスのチャート表示で、負の数値が正しく表示されない。 Y軸は、他の定義済みメトリクスと同様に、常に0から始まる。