Tasks API

Tasks API (Tasks APIs)

*태스크(task)*는 클러스터에서 실행하는 모든 작업이에요. 예를 들어 책 컬렉션에서 제목이나 작가 이름으로 검색하는 것도 하나의 태스크예요. OpenSearch를 실행하면 클러스터의 상태와 성능을 모니터링하는 태스크가 자동으로 생성돼요. 현재 클러스터에서 실행 중인 모든 태스크에 대한 자세한 정보를 보려면 tasks API 작업을 사용할 수 있어요.

도입 버전 1.0

태스크에 헤더 연결

요청을 태스크와 연결해 추적을 개선하고 싶다면, curl 명령의 HTTPS 요청 헤더에 X-Opaque-Id:<ID_number> 헤더를 제공하면 돼요. API는 반환된 결과에 지정한 헤더를 포함해요.

다음 요청은 X-Opaque-Id가 111111인 태스크를 반환해요:

curl -i -H "X-Opaque-Id: 111111" "https://localhost:9200/_tasks" -u 'admin:<custom-admin-password>' --insecure

_tasks 작업은 다음 결과를 반환해요:

HTTP/1.1 200 OK
X-Opaque-Id: 111111
content-type: application/json; charset=UTF-8
content-length: 768

{
  "nodes": {
    "Mgqdm0r9SEGClWxp_RbnaQ": {
      "name": "opensearch-node1",
      "transport_address": "172.18.0.4:9300",
      "host": "172.18.0.4",
      "ip": "172.18.0.4:9300",
      "roles": [
        "data",
        "ingest",
        "master",
        "remote_cluster_client"
      ],
      "tasks": {
        "Mgqdm0r9SEGClWxp_RbnaQ:30072": {
          "node": "Mgqdm0r9SEGClWxp_RbnaQ",
          "id": 30072,
          "type": "direct",
          "action": "cluster:monitor/tasks/lists[n]",
          "start_time_in_millis": 1613166701725,
          "running_time_in_nanos": 245400,
          "cancellable": false,
          "parent_task_id": "Mgqdm0r9SEGClWxp_RbnaQ:30071",
          "headers": {
            "X-Opaque-Id": "111111"
          }
        },
        "Mgqdm0r9SEGClWxp_RbnaQ:30071": {
          "node": "Mgqdm0r9SEGClWxp_RbnaQ",
          "id": 30071,
          "type": "transport",
          "action": "cluster:monitor/tasks/lists",
          "start_time_in_millis": 1613166701725,
          "running_time_in_nanos": 658200,
          "cancellable": false,
          "headers": {
            "X-Opaque-Id": "111111"
          }
        }
      }
    }
  }
}

이 작업은 tasks 작업과 동일한 파라미터를 지원해요. 다음 예제는 X-Opaque-Id를 특정 태스크와 연결하는 방법을 보여줘요:

curl -i -H "X-Opaque-Id: 123456" "https://localhost:9200/_tasks?nodes=opensearch-node1" -u 'admin:<custom-admin-password>' --insecure

Tasks API

Tasks API (Tasks APIs)

태스크에 헤더 연결

관련 문서