カスタム レポートの作成と管理

Cloud コンソールの Apigee

[カスタム レポート] ページを開くには:

1. Cloud コンソールで Apigee UI を開きます。
2. [アナリティクス] > [カスタム レポート] を選択します。

以下のような [カスタム レポート] ページが表示されます。

[カスタム レポート] ページには 2 つのタブがあります。

• レポート: リアルタイム レポートを表示します。
• Report Jobs: レポートジョブを表示します。

リアルタイム レポートとレポートジョブの比較をご覧ください。

どちらのタブにも、作成済みのレポートまたはレポートジョブのリストが表示されます。レポートまたはレポートジョブを表示するには、レポートの名前をクリックします。例については、レポートを実行するをご覧ください。

レポート

[レポート] タブには、各レポートに関する次の情報が表示されます。

• 表示名: レポートの名前。
• ディメンション: レポートに含まれるディメンション。
• 指標: レポートに含まれる指標と集計関数（sum など）。
• 最終更新日: レポートが最後に実行された日時。

Report Jobs

[Report Jobs] タブには、レポートジョブに関する次の情報が表示されます。

• レポート名: レポートの名前。
• Start Time Range（UTC）: レポートジョブの開始時間。
• End Time Range（UTC）: レポートジョブの終了時間。
• ステータス: レポートジョブのステータス（実行中、完了、期限切れ）。
• 送信済み: レポートジョブが送信された日時。

[カスタム レポート] ページでは、以下の操作を行うことができます。

• カスタム レポートとレポートジョブを表示します。
• カスタム レポートまたはレポートジョブを作成します。
• レポートを実行します。
• カスタム レポートまたはレポートジョブを編集します。
• カスタム レポートまたはレポートジョブを削除します。

従来の Apigee

[カスタム レポート] ページを開くには:

1. Apigee UI にログインします。
2. [Analyze] > [Custom Reports] > [Report] を選択します。

次の図のように、カスタム レポート ページには、組織用に作成されたすべてのカスタム レポートが表示されます。

図中にハイライト表示されているように、カスタム レポートページでは次のことが行えます。

• すべてのカスタム レポートのリストを表示する。
• カスタム レポートを追加する。
• リスト内の名前をクリックして、カスタム レポートを実行する。デフォルトでは、レポートは過去 1 時間に収集されたデータを使用して実行され、そのデータがカスタム レポート ダッシュボードに表示されます。カスタム レポート ダッシュボードの詳細をご覧ください。
• 検索ボックスに関連する文字列の全部または一部を入力して、カスタム レポートのリストを検索する。入力した文字列で、表示されているすべてのフィールドが検索されます。
• カスタム レポートを削除する。

カスタム レポート ダッシュボードの詳細

カスタム レポート ダッシュボードに、特定期間のカスタム レポートの結果が表示されます。結果は、指定した指標による棒グラフまたは折れ線グラフで表示されます。

カスタム レポート ダッシュボードでは、以下の操作を行えます。

• 選択した期間のカスタム レポートデータを表示する。
• カスタム レポート データを表示する環境を選択する。
• カスタム レポートデータをフィルタする特定のディメンションを選択する。この領域は、レポートに複数のディメンションを指定した場合のみ有効になります。

• グラフビューまたはテーブルビューを選択する。

• 関連する指標のテーブル行で アイコンを選択して、指標を分析する。異常値を表示して、前の期間や他の指標と比較します。
• 期間をクリックして設定することで、カスタム レポートを実行する。
• CSV ファイルとしてカスタム レポートをダウンロードする。ファイル名は metric.csv になります。例: Average_of_total_response_time.csv
• カスタム レポートを編集する。

Cloud コンソールの Apigee

[カスタム レポート] ページでは、リアルタイム レポートまたはレポートジョブを作成できます。手順は次のとおりです。

1. [カスタム レポート] ページを開きます。
2. [+ 作成] をクリックします。
3. • リアルタイム レポートを作成するには、[カスタム レポート] を選択します。
   • レポートジョブを作成するには、[Custom Report Job] を選択します。
4. [基本] セクションで、次の情報を入力します。
   • レポート名: レポートの名前。
   • リアルタイム レポートの場合は、レポートの説明も入力できます。
5. 以下のセクションは、レポートジョブのリアルタイム レポートを作成するかどうかによって異なります。
   • リアルタイム レポートの場合のみ:

     [グラフの種類] で、データを表示するグラフのスタイルを選択します。

     • 列: X 軸は、ディメンションで指定されたグループを表します。
     • 行: X 軸は、時間を表します。

   • レポートジョブの場合のみ:
     • レポートの詳細: [環境] フィールドで、レポートを実行する環境を選択します。リアルタイム レポートの場合は、レポートの実行後にレポートページで環境を選択できます。
     • レポート期間: レポートの開始時間と終了時間を選択します。

       注: レポートジョブの最大期間は 365 日です。秒単位の期間が必要なレポートの場合は、カスタム レポート API を使用してレポートジョブを作成します。この API は、秒を含む期間の入力を受け入れます。

6. [指標] セクションで、以下の操作を行います。
   1. 分析する指標を選択します。
   2. 合計値、平均値、最小値、最大値の表示に使用する集計関数を選択します。
   3. [完了] をクリックします。

   注:標準の指標とディメンションに加えて、DataCapture ポリシーを使用して収集したカスタムデータに対応する指標またはディメンションも選択できます。

7. [ディメンション] フィールドで、ディメンション（「Proxy」など）を選択して、レポートの生成に使用されるデータセットを制限します。別のディメンションを追加して、データをさらに制限することもできます。

8. [フィルタ] セクションで、レポート定義にフィルタを追加することで、表示されるデータをさらに絞り込むことができます。たとえば、天気情報の API プロキシや、デベロッパー jane@example.com のデータを除外するフィルタを追加できます。

   まず、[フィルタを追加] をクリックして [新しいフィルタ] セクションを開きます。

   1. フィルタを適用するエンティティの名前（指標またはディメンション）を選択します。
   2. =、!= などの演算子と値を選択します。
   3. 指標またはディメンションの値を入力します。
   4. [完了] をクリックしてフィルタを追加します。
9. [保存] をクリックしてレポートを保存します。

従来の Apigee

カスタム レポートを追加するには:

1. [カスタム レポート] ページを開きます。
2. [+ Custom Report] をクリックします。
3. [Basic] セクションで、次の情報を入力します。

   フィールド	説明
   Report name	レポートの名前。
   Report description	レポートの説明。
   グラフの種類	カスタム分析データの表示に使用するグラフのスタイルを選択します。 Column: X 軸は、ディメンションで指定されたグループを表します。 Line: X 軸は、時間を表します。

4. [Metrics] セクションで、以下を行います。
   1. [Metrics] の アイコンをクリックします。
   2. 分析する指標を選択します。
   3. 合計値、平均値、最小値、最大値の表示に使用する集計関数を選択します。
   4. [保存] をクリックします。
   5. アイコンをクリックして、指標を追加します。

   注:標準の指標とディメンションに加えて、DataCapture ポリシーを使用して収集したカスタムデータに対応する指標またはディメンションも選択できます。

5. [Dimensions] セクションで、 をクリックし、ディメンション（Proxy など）を選択して、レポートの作成に使用したデータセットを制限します。別のディメンションを追加して、データをさらに制限することもできます。

6. [Filter] セクションで、レポート定義にフィルタを追加して、表示されるデータをさらに絞り込みます。たとえば、天気情報の API プロキシや、デベロッパー jane@example.com のデータを除外するフィルタを追加できます。

   1. をクリックし、フィルタの対象となるエンティティの名前、演算子（=、!= など）、値を選択します。
   2. [Add] をクリックしてフィルタを保存します。
   3. をクリックしてフィルタを追加し、AND または OR のコネクタを選択します。
7. [Save] をクリックしてレポートを保存します。

Cloud コンソールの Apigee

リアルタイム レポートを実行するには:

1. [カスタム レポート] ページを開きます
2. [レポート] タブで、実行するレポートを選択します。

レポートの準備が整うと、次のように表示されます。

レポートに、データのグラフとサマリー テーブルが表示されます。

[レポート] ページでは、レポートの次のオプションを選択できます。

• 環境: レポートを実行する環境。
• レポートの期間。
• ディメンション: レポートのディメンション。一度に表示できるディメンションは一つだけです。
• 値: ディメンションの特定の値。[すべて] にすると、すべての値が表示されます。

レポートページの上部で次のオプションを選択することもできます。

• 編集: レポートの詳細を編集します。
• エクスポート: レポートのデータを CSV ファイルでダウンロードします。
• ジョブを送信: レポートジョブとしてレポートを送信します。[ジョブを送信] をクリックするとダイアログが開き、カスタム レポートを作成するで説明されているオプションが表示されます。オプションを入力したら、[作成] をクリックしてレポートジョブを作成します。

レポートジョブの詳細については、レポートジョブを表示するをご覧ください。

従来の Apigee

特定の期間のカスタム レポートを実行するには:

1. [Custom reports] ページにアクセスします。
2. 実行するレポートを選択します。デフォルトでは、レポートには直近 1 時間のデータが表示されます。

   注: レポートの実行に 60 秒以上かかる場合は、自動的にリアルタイム レポートに変換されます。

3. 別の期間のレポートを実行するには、次のようにします。

   1. レポートの上部にある期間の領域をクリックして、[Custom Report Time Selection] ポップアップを開きます。
   2. 次のいずれかを選択します。
      • 事前定義された期間（[Last Hour]、[Yesterday]、[Last 7 Days] など）。

      • カスタムの範囲。[From] / [To] で日時を選択するか、カレンダーを使用して開始日と終了日を選択します。世界標準時（UTC）を使用するには、[UTC] をクリックします。

   3. レポートを実行するには、次のいずれかを選択します。

      • 適用。レポートを実行します。結果は、レポートの完了後にカスタム レポート ダッシュボードに表示されます。

      • ジョブの送信。レポートをレポートジョブとして実行します。次のダイアログが表示されます。

        

        ダイアログの [ステータスを表示] をクリックすると、レポートジョブのステータスが表示されます。

Cloud コンソールの Apigee

レポートジョブを表示するには、[カスタム レポート] ページの上部にある [Report Jobs] タブを選択します。

以下のように、[Report Jobs] タブが表示されます。

[Report Jobs] ページでは、以下の操作を行うことができます。

• 過去 7 日間に送信されたすべてのレポートジョブを表示する。

• レポートジョブを表示する環境を選択する。

• 検索ボックスに関連する文字列の全部または一部を入力して、カスタム レポートのリストを検索する。入力した文字列で、表示されているすべてのフィールドが検索されます。

カスタム レポートを表示するには、[ステータス] が「完了」であることを確認します。レポート名をクリックしてレポートを表示します。

従来の Apigee

レポートジョブを表示するには、次のいずれかを行います。

• [Report Submitted as Background Job] ダイアログで [View Status] をクリックする。
• 左側のナビゲーション バーで [Analyze] > [Custom Reports] > [Report Jobs] を選択する。

次の図に示すように、[Report Jobs] ページが表示されます。

[Report Jobs] ページでは、以下の操作を行うことができます。

• 過去 7 日間に送信されたレポートジョブの結果すべてを表示します。

• レポートジョブを表示する環境を選択する。

• カスタム レポートを表示するには、[ステータス] が「完了」であることを確認します。次に、レポートに対応する行の上にマウスを移動します。 と アイコンが表示されます。 を選択すると、レポートが表示されます。

• カスタム レポートをダウンロードします。

Cloud コンソールの Apigee

カスタム レポートを編集するには:

1. [カスタム レポート] ページを開きます
2. [操作] のその他メニューをクリックします。
3. [編集] を選択します。[Edit custom report] ダイアログが開き、レポートのオプションを編集できます。オプションについては、カスタム レポートを作成するをご覧ください。
4. [更新] をクリックして、変更を保存します。

従来の Apigee

カスタム レポートを編集するには:

1. [カスタム レポート] ページを開きます。
2. 編集するレポートの名前にカーソルを合わせます。編集アイコン（）と削除アイコン（）がページの右側に表示されます。
3. 編集アイコンをクリックします。
4. カスタム レポートの詳細を編集します。
5. [Save] をクリックします。

カスタム レポートの結果に戻ります。

Cloud コンソールの Apigee

1. [カスタム レポート] ページを開きます
2. [操作] のその他メニューをクリックします。
3. [削除] をクリックして、レポートを削除します。

従来の Apigee

カスタム レポートを削除するには:

1. [カスタム レポート] ページを開きます。
2. 編集するレポートの名前にカーソルを合わせます。編集アイコン（）と削除アイコン（）がページの右側に表示されます。
3. 削除アイコンをクリックしてレポートを削除します。