データソース
データソースは、プロジェクトカタログ、ジョブ履歴、Data tablesなど、ワークスペースの特定部分から取得します。 利用可能なデータソースは、ワークスペースでのロールと権限によって異なります。 たとえば、アクセス可能なプロジェクト内のData tablesのみを表示できます。 詳細については、ロールと権限の管理を参照してください。
データソースを選択
クエリビルダー
次の表では、各データソースで利用可能なデータの種類について説明します。
| データソース | 説明 | 利用可能なデータ |
|---|---|---|
| ワークスペースデータ（プロジェクト） | ワークスペース内のすべてのプロジェクトに関連するデータを表示します。 |
|
| ワークスペースデータ（レシピ） | ワークスペース内のすべてのレシピに関連するデータを表示します。 |
|
| ワークスペースデータ（ジョブ履歴） | ワークスペースについて、過去365日間のジョブ履歴データを表示します。 |
|
| 個別レシピのジョブ履歴 | 指定したレシピについて、過去365日間のレシピジョブ履歴データを表示します。 |
|
| Data tables | 指定したData tableのデータを表示します。 |
|
| Workflow apps | 指定したWorkflow appsからデータを表示します。 |
レポートビルダー
レポートビルダーは、構築済みのメトリックとディメンションを使用してチャートにデータを入力します。
データソースを選択
レポートビルダーは、さまざまなレポートニーズに対応するメトリクスとディメンションを提供します。 回答しようとしている質問に一致する領域を選択します:
- オートメーションの健全性: ジョブの成功率と失敗率、アクティブなレシピ、未使用のレシピ（アクティブだがジョブを処理していないもの）。 インテグレーションを参照してください。
- APIトラフィックとガバナンス: リクエスト量、レイテンシ、失敗率、または非アクティブなクライアント。 APIを参照してください。
- ワークスペースアクティビティ: 参加したユーザー、変更されたコネクション、またはレシピが作成および変更された日時。 監査とガバナンスを参照してください。
- プラットフォーム消費量とチャージバック: チームまたはプロセスが消費するクレジット、ビジネスアクション、またはAPI呼び出し。 利用状況を参照してください。
利用可能なメトリックとディメンションはすべてのチャートタイプで同じですが、用語は異なります：
| チャートタイプ | メトリックラベル | ディメンションラベル |
|---|---|---|
| 折れ線、棒、面 | Y軸 | X軸 |
| 円 | メトリクス | ディメンション |
| テーブル | Metrics | Dimensions |
| KPI | メトリクス | なし |
互換性のあるメトリックとディメンション
メトリックとディメンションはすべてを相互に置き換えられるわけではありません。 Workatoは、メトリックを選択するとディメンションのリストをフィルタリングして互換性のあるオプションのみを表示し、ディメンションを選択した場合も同じ処理を行います。 たとえば、ジョブステータスはジョブのレポートでは利用できますが、コラボレーターのレポートでは利用できません。
プライベートベータ
Report builderはプライベートベータ版です。 プライベートベータ機能は招待制でのみ利用できます。 この機能を有効にするには、Customer Success Managerにお問い合わせください。
Workatoは、プライベートベータ期間中、事前の通知なしに機能の機能性を更新したり、提供状況を変更したりする場合があります。
このリファレンスでは、利用可能なメトリクスとディメンションを4つのレポート領域に分類しています。 各領域には、測定できるメトリクスと、グループ化およびフィルタリングに使用できるディメンションが一覧表示されています。
データリテンション
レポートビルダーは現在、限られた期間のみデータを保持します:
- インテグレーション、API、監査とガバナンスでは、過去365日までのレポートを作成できます。
- 利用状況では、現在アクティブな会計期間のみがレポートされます。
インテグレーション
レシピとジョブの健全性を測定します。
メトリクス
| メトリクス | カテゴリ | 説明 |
|---|---|---|
| 有効なレシピ | レシピ | ワークスペース内の有効なレシピの数。 |
| アクティブなプロジェクト | レシピ | 少なくとも1つのアクティブなレシピを含む一意のプロジェクト数。 |
| 未使用のレシピ | レシピ | 過去30日間にジョブを処理しなかったアクティブなレシピ数。 |
| レシピ成功率 | レシピ | 合計ジョブに対する成功ジョブの比率として、正常に完了したジョブの割合。 |
| レシピ失敗率 | レシピ | 合計ジョブに対する失敗ジョブの比率として、失敗したジョブの割合。 |
| 合計ジョブ | ジョブ | 選択した期間中に開始され、その後完了したジョブの合計数。結果は問いません。 |
| 成功したジョブ | ジョブ | 正常に完了したジョブの合計数。 |
| 失敗したジョブ | ジョブ | 失敗したジョブの合計数。 |
| ジョブタスク | ジョブ | ジョブ全体で実行されたタスクステップ数。 合計タスク消費量にはSUMを使用し、レシピの複雑さを把握するにはAVGを使用します。このメトリクスは今後、利用状況データセットに移動されます。 |
| ジョブ期間 | ジョブ | ジョブの合計実行時間（ミリ秒）。 |
時間軸のないメトリクス
アクティブなレシピ、アクティブなプロジェクト、未使用のレシピはワークスペースの現在の状態をレポートするため、日付ディメンションを追加して時間の経過に沿ってチャート化することはできません。
レートメトリクス
レシピ成功率とレシピ失敗率は、0.94のような比率を返します。 チャートの数値書式設定を使用して、パーセンテージとして表示します。
数値メトリックの数値書式設定オプション
ディメンション
| ディメンション | カテゴリ | 説明 |
|---|---|---|
| 日付 | 共通 | レポートの時間軸。 結果は日、週、または月でグループ化できます。 |
| 開始日時 | ジョブ | ジョブが開始された日時。 |
| 完了日時 | ジョブ | 成功または失敗に関係なく、ジョブが終了した日時。 |
| ジョブステータス | ジョブ | 成功や失敗など、ジョブの最終結果。 |
| エラータイプ | ジョブ | 失敗タイプを表す標準化されたエラーコードまたはカテゴリ。 たとえば、400 Bad Request、409 Conflict、またはINVALID_IDです。 |
| エラーアプリケーション | ジョブ | ジョブの失敗原因となったアプリケーションコネクター。 |
| レシピ名 | レシピ | ワークスペースで設定されたレシピの名前。 |
| レシピアプリケーション | レシピ | レシピで使用されるアプリケーションのリスト。 |
| Status | レシピ | レシピの現在のステータス。 |
| トリガーアプリケーション | レシピ | レシピの開始をトリガーするアプリケーション。 |
| プロジェクト名 | 共通 | アセットまたはイベントが属するプロジェクト。 |
| Environment名 | 共通 | ワークスペースのEnvironment。 たとえば、Development、テスト、またはプロダクションです。 |
| Environmentタイプ | 共通 | ワークスペースのEnvironmentのタイプ。 例: dev、test、またはprod。 |
| アセットタグ | 共通 | アセットに付加されたラベル。 |
日付ディメンションについて
日付ディメンションを使用して、期間中のアクティビティを測定するメトリクスに時間軸を追加します。 Workatoはこれを各メトリクスに適した時間列に自動的にマッピングするため、どのメトリクスでも一貫して機能します。
API
このセクションでは、2種類のメトリクスを通じてAPI platformを可視化します:
- インベントリ: APIアクセスポリシー、クライアント、コレクション、エンドポイントなど、構成済みのAPI platformリソースの現在の数。
- トラフィック: 選択した期間におけるAPIリクエスト量を示す時系列リクエストデータ。
メトリクス
| メトリクス | タイプ | 説明 |
|---|---|---|
| APIアクセスポリシー | 在庫 | ユーザーがアクセスできるすべてのAPIアクセスポリシー。 |
| APIクライアント | 在庫 | ユーザーがアクセスできるすべてのAPIクライアント。 |
| APIコレクション | 在庫 | ユーザーがアクセスできるすべてのAPIコレクション。 |
| APIエンドポイント | 在庫 | ユーザーがアクセスできるすべてのAPIエンドポイント。 |
| ワークスペース | 在庫 | クライアントが利用できるワークスペース。 |
| APIチャーンクライアント | トラフィック | 過去365日以内にAPI呼び出しが0件のAPIクライアント。 |
| アクティブなAPIアクセスポリシー | トラフィック | 選択した期間中のAPIリクエストで使用された個別のAPIアクセスポリシー数。 |
| APIアクティブクライアント | トラフィック | 選択した期間中に少なくとも1件のAPIリクエストを行った個別のAPIクライアント数。 |
| APIアクティブコレクション | トラフィック | 選択した期間中のAPIリクエストで使用された個別のAPIコレクション数。 |
| APIアクティブエンドポイント | トラフィック | 選択した期間中にAPIリクエストで使用された個別のAPIエンドポイント数。 |
| APIリクエスト | トラフィック | APIリクエストの件数。 非アクティブなAPIエンティティは含まれません。 |
| 成功したAPIリクエスト | トラフィック | 成功したAPIリクエストの件数。 リクエストは、2xxまたは3xx範囲のレスポンスコードを返す場合に成功と見なされます。 |
| APIリクエスト成功率 | トラフィック | 合計APIリクエストに対する成功したAPIリクエストの割合。 |
| 失敗したAPIリクエスト | トラフィック | 失敗したAPIリクエストの件数。 リクエストは、4xxまたは5xx範囲のレスポンスコードを返す場合に失敗と見なされます。 |
| APIリクエスト失敗率 | トラフィック | 合計APIリクエストに対する失敗したAPIリクエストの割合。 |
| APIリクエスト時間（レイテンシ） | トラフィック | APIリクエストの時間（ミリ秒）。 |
| APIリクエストのピーク同時実行数 | トラフィック | 選択した期間中に観測された同時APIリクエストの最大数。 |
| APIリクエストの日次件数 | トラフィック | 非アクティブなエンティティ（件数0を返す）を含む、各APIエンティティの日次APIリクエスト件数。 |
| APIリクエストの日次平均 | トラフィック | 各APIエンティティの1日あたりの平均APIリクエスト件数。 |
ディメンション
| ディメンション | 説明 |
|---|---|
| 日付 | レポートの時間軸。 結果は日、週、または月でグループ化できます。 |
| コレクション名 | APIコレクションの名前。 |
| コレクションタイプ | APIコレクションのタイプ。 |
| コレクションバージョン | APIコレクションのバージョン。 |
| エンドポイント名 | APIエンドポイントの名前。 |
| APIエンドポイントがアクティブ | APIエンドポイントのアクティビティステータス。アクティブ化または非アクティブ化のいずれか。 |
| HTTPメソッド | APIエンドポイントのHTTPメソッド。 |
| パス | APIエンドポイントのパス。 例: /orders/{id}。 |
| アクセスプロファイル | APIアクセスポリシーの名前。 |
| アクセスポリシーがアクティブ | アクセスポリシーのアクティビティステータス。アクティブ化または非アクティブ化のいずれか。 |
| クライアント名 | APIクライアントの名前。 |
| リクエスト結果 | 成功または失敗など、APIリクエストの結果。 |
| レスポンスHTTPコード | APIリクエストに対して返されたHTTPレスポンスコード。 例: 200、400、または500。 |
| リクエスト時間 | APIリクエストの時間（ミリ秒）。 |
| MCPかどうか | APIリクエストがMCPクライアントによって行われたかどうかを示します。 |
| ワークスペース名 | ワークスペースの表示名。 |
監査とガバナンス
ワークスペースアクティビティを追跡します: 参加したユーザー、変更されたコネクション、レシピのライフサイクルイベント。
データリテンション
監査とガバナンスのメトリクスでは、過去365日までのレポートを作成できます。
メトリクス
| メトリクス | カテゴリ | 説明 |
|---|---|---|
| ワークスペースに追加されたコラボレーター | コラボレーター | 招待を承諾してワークスペースに参加したコラボレーターの数。 |
| 招待されたコラボレーター | コラボレーター | 選択した期間内に新しいコラボレーターに送信された招待の数。 |
| 削除されたコラボレーター | コラボレーター | 選択した期間内にワークスペースから削除されたコラボレーターの数。 |
| コラボレーターのログイン | コラボレーター | 選択した期間内にコラボレーターがワークスペースにログインした回数。 |
| コラボレーターのロール更新 | コラボレーター | 選択した期間内にコラボレーターに対して行われたロール変更の数。 変更内容を確認するには、ユーザーの以前のロールディメンションとユーザーロールディメンションを使用します。 |
| コネクション作成済み | コネクション | 選択した期間内に作成された新しいコネクションの数。 |
| コネクション接続済み | コネクション | 選択した期間内に正常に認証されたコネクションの数。 |
| コネクション切断済み | コネクション | 選択した期間中に認証済み状態を失ったコネクション数。 |
| 更新されたコネクション | コネクション | 選択した期間内に再認証または再設定されたコネクションの数。 |
| レシピの作成 | レシピ | 選択した期間内に作成されたレシピの数。 自動化ライブラリの成長を追跡するには、累積ビューを使用します。 |
| レシピの更新 | レシピ | 選択した期間内に変更されたレシピの数。 |
| レシピの削除 | レシピ | 選択した期間内に完全に削除されたレシピの数。 |
| レシピの開始 | レシピ | 選択した期間内にレシピがオン（有効化）された回数。 |
| レシピの停止 | レシピ | 選択した期間内にレシピがオフ（無効化）された回数。 |
ディメンション
| ディメンション | カテゴリ | 説明 |
|---|---|---|
| 日付 | 共通 | レポートの時間軸。 結果は日、週、または月でグループ化できます。 |
| 実行者 | コラボレーター | アクションを実行したユーザーのメールアドレス。 |
| ユーザーのメールアドレス | コラボレーター | ワークスペース内のコラボレーターのメールアドレス。 |
| ユーザー名 | コラボレーター | コラボレーターのプロファイルに設定されている表示名。 |
| ユーザーロール | コラボレーター | ワークスペース内のコラボレーターの現在の権限ロール。 |
| ユーザーの以前のロール | コラボレーター | ロール変更前にコラボレーターに割り当てられていた権限ロール。 |
| ユーザーの招待者 | コラボレーター | このコラボレーターに招待を送信したユーザーのメールアドレス。 |
| コネクション名 | コネクション | コネクションの表示名。 |
| コネクションアプリケーション | コネクション | SalesforceやSlackなど、コネクションに関連付けられたアプリケーション。 |
| コネクションタイプ | コネクション | CloudやOPAなど、コネクションの認証タイプ。 |
| レシピ名 | レシピ | ワークスペースで設定されたレシピの名前。 |
| プロジェクト名 | 共通 | アセットまたはイベントが属するプロジェクト。 |
| Environment名 | 共通 | ワークスペースのEnvironment。 たとえば、Development、テスト、またはプロダクションです。 |
| Environmentタイプ | 共通 | ワークスペースのEnvironmentのタイプ。 例: dev、test、またはprod。 |
監査メトリクスのディメンション可用性
一部のディメンションは、特定の監査イベントタイプにのみ適用されます:
- プロジェクト名とEnvironment名は、コネクションおよびレシピライフサイクルメトリクスで利用できますが、コラボレーターメトリクスでは利用できません。
- ユーザーメールは、コラボレーターメトリクスでのみ利用できます。
- ユーザー名は、コネクションおよびレシピライフサイクルメトリクスでのみ利用できます。
利用状況
プラットフォーム消費量を測定します。これは、チャージバックやプランのクレジット消費量の追跡に役立ちます。
メトリクス
| メトリクス | 説明 |
|---|---|
| ビジネスアクション数 | ビジネスアクションは、ワークフローレシピ内の成功したトリガーまたはアクションステップです。 特定のWorkatoユーティリティは除外されます。 |
| APIコール | 管理対象APIレシピの利用状況。 |
| APIプロキシ呼び出し | WorkatoのAPI Gatewayを経由してルーティングされたAPI呼び出し。 |
| クレジット | 消費されたクレジット。 |
| 処理済みイベント数 | Event streamsの利用状況単位。 publishアクションのみをカウントします。 Event streamsトリガーは除外されます。 |
| Genieアクション | Genie入力とレスポンス（1ターン）。 |
| 処理されたIDPページ | Intelligent Document Processing（IDP）によって処理されたページ。 |
| MCPツール呼び出し | 成功したMCPツール呼び出し。 |
| 消費された行 | データパイプラインによって消費された行。 |
ディメンション
| ディメンション | カテゴリ | 説明 |
|---|---|---|
| 日付 | 共通 | レポートの時間軸。 結果は日、週、または月でグループ化できます。 |
| 利用状況タイプ | 利用状況 | ビジネスアクション、API呼び出し、消費された行、処理されたページなど、消費されている製品メトリクス。 |
| ワークスペース名 | 共通 | ワークスペースの表示名。 |
| Environment名 | 共通 | ワークスペースのEnvironment。 たとえば、Development、テスト、またはプロダクションです。 |
| プロジェクト名 | 共通 | アセットまたはイベントが属するプロジェクト。 |
| レシピ名 | レシピ | ワークスペースで設定されたレシピの名前。 |
| アセットタグ | 共通 | アセットに付加されたラベル。 |
| Environmentタイプ | 共通 | ワークスペースのEnvironmentのタイプ。 例: dev、test、またはprod。 |
| コレクション名 | API | APIコレクションの名前。 |
| エンドポイント名 | API | APIエンドポイントの名前。 |
利用状況メトリクスのディメンション可用性
一部のディメンションは、特定の利用状況メトリクスにのみ適用されます:
- プロジェクト名、レシピ名、アセットタグは、APIプロキシ呼び出し、Genieアクション、MCPツール呼び出しメトリクスでは利用できません。 これらのメトリクスでは、代わりにワークスペース名とEnvironment名で利用状況をグループ化およびフィルタリングします。
- コレクション名とエンドポイント名は、APIプロキシ呼び出しおよびAPI呼び出しメトリクスでのみ利用できます。
Last updated: