# コンポーネントメトリクスのエンドポイント

| メソッド | Endpoint | 説明 | クエリーパラメーター | ボディ |
| --- | --- | --- | --- | --- |
| GET | /monitoring/observability/executions/{runId}/component | 指定されたタスク実行のコンポーネントメトリクスを取得します。 | <ul> <li><span>limit</span>: 返すエントリーの数。デフォルト値は50で、最大値は200です。 </li> <li><span>offset</span>: エントリーのページネーションの開始位置で、0以上となります。</li> <li><span>sortBy</span>: 返されたエントリーのソート基準となるフィールドです。デフォルト値は<span>component_start_time_seconds</span>です。利用できるすべての値については、<a href="https://help.qlik.com/talend/ja-JP/api-user-guide/Cloud/observability-metrics-endpoints">sortBy</a>をご覧ください。</li> <li><span>sortOrder</span>: 返されたログのソート方法で、<span>desc</span>と<span>asc</span>のいずれかです。デフォルト値は<span>desc</span>で、これは降順であることを意味します。 <p>昇順か降順かにかかわらず、NULLフィールドや空のフィールドは常に、レスポンスで返されるリストの最後に置かれます。</p></li> </ul><br><br>これらのパラメーターはすべてオプションです。 | 該当せず |
| POST | /monitoring/observability/metrics/component | 生のコンポーネントメトリクスデータを検索します。 | パラメーターがありません。 | ```<br>{<br>"environmentId": "6093f6a36f01d639680d31cd",<br>"startTime": "2021-09-08T06:58:04.604Z",<br>"endTime": "2021-09-08T06:58:06.463Z",<br>"limit": 50,<br>"offset": 0,<br>"sortBy": "component_start_time_seconds",<br>"sortOrder": "asc",<br>"filters": [<br>{<br>"field": "engine_id",<br>"operator": "in",<br>"value": ["a60bb1c0-7669-407f-9326-138af05da18a"]<br>},<br>{<br>"field": "component_start_time_seconds",<br>"operator": "gte",<br>"value": 1628266578<br>}<br>]<br>}<br>```<br><br>ボディで使用するフィールドの詳細は、次のセクションをご覧ください。 |

## 観測可能なメトリクスエンドポイントで使われるフィールド

- environmentId
- 必須の有無
    - タスクとそのスペースが属している環境のID
- startTime
- 必須の有無
    - ジョブタスクにあるコンポーネントが動作を開始する時刻。使用するISO形式はyyyy-MM-dd'T'HH:mm:ss.SSS'Z'で、たとえば2021-09-08T06:58:04.604Zとなります。
- endTime
- 必須の有無
    - ジョブタスクにあるコンポーネントが動作を終了する時刻。使用するISO形式はyyyy-MM-dd'T'HH:mm:ss.SSS'Z'で、たとえば2021-09-08T06:59:04.804Zとなります。  startTimeはendTimeよりも前でなくてはなりません。
- limit
- オプション
    - 返すエントリーの数。デフォルト値は50で、最大値は200です。
- offset
- オプション
    - エントリーのページネーションの開始位置で、0以上となります。
- sortBy
- オプション
    - 返されたエントリーのソート基準となるフィールドです。デフォルト値はcomponent\_start\_time\_secondsです。使用されるフィールドは次のとおりです。 * account\_id * engine\_id * engine\_type * engine\_version * workspace\_id * task\_id * task\_execution\_id * process\_id: JVMのUUID * /JobName * pid: 現在の実行の一意ジョブ識別子 * father\_pid: 最初の直系親ジョブの一意識別子 * root\_pid: 複数のサブジョブが複数ある場合は最初のルートジョブのID * connector\_type * connector\_label * connector\_id * target\_connector\_type * target\_label * target\_id * connection\_type * connection\_name * Availability-note[Deprecated](https://help.talend.com/r/en-US/Cloud/labels-on-talend-help-center/availability-deprecated)    このコンテンツは非推奨になりました。    component\_start\_time\_seconds * component\_connection\_rows\_total * component\_execution\_duration\_milliseconds
- sortOrder
- オプション
    - 返されたログのソート方法で、descとascのいずれかです。デフォルト値はdescで、これは降順であることを意味します。  昇順か降順かにかかわらず、NULLフィールドや空のフィールドは常に、レスポンスで返されるリストの最後に置かれます。
- filters
- オプション
    - monitoring/observability/metrics/componentに送信された検索リクエストでメトリクスデータをフィルタリングするために使われます。例: ``` {     "field": "connector_id",      "operator": "in",      "value": ["tMongoDBConnection_1"] } ```  このフィルターはconnector\_idフィールドに適用され、ID がtMongoDBConnection\_1であるコンポーネントに関連するメトリクスデータを検索します。 ``` {     "field": "component_start_time_seconds",      "operator": "gt",      "value": 1628266578 } ```  このフィルターはcomponent\_start\_time\_secondsフィールドに適用され、1628266578より後に実行が開始されたコンポーネントに関連するメトリクスデータを検索します。 ``` {     "field": "operator_type",      "operator": "in",      "value": ["HUMAN", "SERVICE"] } ```  このフィルターはoperator\_typeフィールドに適用され、ユーザーまたはサービスアカウントによって開始されたタスクに関連するメトリクスデータを検索します。  フィルターで使用されるフィールドは次のとおりです。 * engine\_id * engine\_type * engine\_version * workspace\_id * task\_id * task\_execution\_id * /JobName * connector\_type (たとえばtMongoDBConnection) * connector\_label (たとえばtMongoDBConnection\_1) * connector\_id (たとえばtMongoDBConnection\_1) * component\_start\_time\_seconds: このフィールドではgt、gte、lt、lteのみのサポート、他のフィールドではinのみのサポート * operator: タスクを開始するユーザーまたはサービスアカウントのID * operator\_type: ユーザーであればHUMAN、サービスアカウントであればSERVICE  フィルターで使われる演算子は次のとおりです。 * in: 配列で値を一致させます。 * gt: 指定した値より後のもの。数値または数値の文字列が必要です。 * gte: 指定した値に等しいかそれより後のもの。数値または数値の文字列が必要です。 * lt: 指定した値より前のもの。数値または数値の文字列が必要です。 * lte: 指定した値に等しいかそれより前のもの。数値または数値の文字列が必要です。