カスタム・メトリック

カスタム・メトリックについて

  • レポートのニーズに応じて、スパンのメトリックの収集方法を構成できます。
  • ユーザーは、スパンのプロパティに基づいてメトリックの独自の定義を設定できます。これにより、アプリケーションを監視するカスタマイズした方法を構成できます。
  • カスタム・メトリックは、スパン・フィルタを使用して、メトリックを計算するスパンを選択します。これにより、様々なタイプのスパンに対して様々なメトリック・セットを定義できます。
  • ファイングレイン・レポートの場合は、メトリックにディメンションを割り当てて、それらのディメンションに基づいてグループ化およびフィルタリングできます。たとえば、ブラウザ・タイプごとにユーザーをレポートしたり、国ごとに販売された記事をレポートします。
  • カスタム・メトリックはAPMドメイン・レベルで構成されます。

カスタム・メトリックの使用例

例1: チェックアウト・ステップ中に発生したエラーの数を追跡するメトリックを作成します。

このユースケースでは、チェックアウト・ステップで失敗したスパンを識別する必要があります。チェックアウト・ページのURLがcheckout.jspで終わると仮定すると、 HttpUrl属性がcheckout.jspで終わるかどうかをチェックし、Error属性がtrueに設定されているかどうかもチェックするSpan Filterを定義できます。

HttpUrl like '%checkout.jsp' AND Error = 'true'

値ソースとして、SpanErrorCountを選択します。この値は、ページにエラーがある場合は1、それ以外の場合は0になります。また、BrowserNameディメンションを追加できるように、特定のブラウザでのみエラーが発生するかどうかを知ることは興味深い場合があります。

例2: ホーム・ページのレスポンス時間を追跡するメトリックの作成

このシナリオでは、ホーム・ページのレスポンス時間を追跡します。この場合、PageResponseTime値ソースを使用できます。home.phpというホームページと一致するようにSpan Filterを設定できます。

HttpUrl like '%home.php' AND ApmrumType = 'PAGE'

ここで、値ソースとしてPageResponseTimeを選択します。また、適合するとおりにディメンションを追加できます。たとえば、GeoCountryは、国ごとのレスポンス時間の内訳を取得します。

カスタム・メトリックの管理

目的のAPMドメインのカスタム・メトリックを作成するには、次を実行します:
  • 「APMドメイン」ページに移動し、目的のAPMドメインをクリックします。

    「ドメインの詳細」ページが表示されます。

  • 左下にある「リソース」に移動し、「カスタム・メトリック」をクリックします

    「カスタム・メトリック」ペインが表示されます。

  • 「カスタム・メトリック」ペインで、「カスタム・メトリックの作成」をクリックします。

    「カスタム・メトリックの作成」ウィンドウが表示されます。

    • 新しいカスタム・メトリックのメトリック名を入力します。
    • 「スパン・フィルタ」ボックスから、事前定義済(グローバル)スパン・フィルタを選択するか、ローカル・スパン・フィルタ定義を入力します。
    • 「メトリック値ソース」ドロップダウン・リストから、メトリックを選択します。
    • オプション: 「ディメンション」ドロップダウン・リストから、1つ以上のディメンションを選択します。ディメンションの最大数は10です。
    • オプション: 「メトリック単位」ドロップダウン・リストから、メトリック単位を選択します。
    • オプション: 「カスタム・メトリックの検証」をクリックして、最近取得したスパンが構成済スパン・フィルタと一致するかどうかを確認します。検証ツールでは、取得したスパンを過去24時間までチェックできます。
    • 「次」をクリックして、「メトリック記憶域の選択」オプションに進みます。
    • 「コンパートメント」ドロップダウン・リストからコンパートメントを選択します。
    • 「Namespace」フィールドで、ネームスペースを入力します。

      すべてのカスタム・メトリックのデフォルト・ネームスペースはoracle_apm_customです。

      カスタム・ネームスペースの使用:必要に応じて、カスタム・メトリックで使用されるカスタム・ネームスペースを指定できます。

      デフォルト以外の名前空間を使用する場合は、新しい名前空間にポリシーを作成する必要があります。

      • 「ネームスペース」フィールドで、デフォルト値を編集し、優先ネームスペースを入力します。
      • 新しいネームスペースに必要なポリシー・メッセージが表示され、次のポリシーが必要であることが示されます:
        Allow service applicationperformancemonitoring to manage metrics in compartment <compartment_name> where target.metrics.namespace=<custom_namespace_name>
        例:
        Allow service applicationperformancemonitoring to manage metrics in compartment ABC where target.metrics.namespace=namespace2

        前述のポリシーにより、OCI Application Performance Monitoringサービスはカスタム・ネームスペースに公開できます。

        次のオプションがあります:
        • ポリシーのコピー: ポリシーはクリップボードにコピーされ、OCIコンソールを使用して手動で作成する必要があります。

          OCIでポリシーを作成する権限がない場合は、このオプションを使用します。ほとんどの場合、管理者ユーザーはポリシーを作成する必要があります。

        • ポリシーの検証: ポリシーは、テスト・メトリックを使用してカスタム・ネームスペースの権限をチェックすることで検証されます。
        • ポリシーの適用: ポリシーは自動的に作成されます。

          OCIでポリシーを作成する権限がある場合は、このオプションを使用します。たとえば、管理者権限があるとします。

        ポリシーの作成方法の詳細は、アイデンティティ管理ドキュメントのポリシーの作成を参照してください。

    • オプション: 「リソース・グループ」ドロップダウン・リストから、リソース・グループを選択します。
    • 「作成」をクリックします。

      カスタム・ネームスペースの使用時に作成プロセスが失敗した場合は、Application Performance Monitoringサービスにカスタム・ネームスペースへの書込み権限があるかどうかを確認します。

アクション・メニューを使用して、カスタム・メトリックを編集または削除します。

既存のカスタム・メトリックがあり、(デフォルト・ネームスペースoracle_apm_customを使用せずに)カスタム・ネームスペースの使用を開始するように更新する場合は、前述のポリシーがカスタム・ネームスペースに適用されていることを確認します。