UI를 사용하여 라우트 작성

UI를 사용하여 경로를 생성하려면 다음 단계를 완료하세요.

1. IBM Cloud 계정에 로그인 합니다.

2. 메뉴 아이콘 > 관측성을 클릭하십시오.

3. 로깅 > 라우팅을 클릭합니다.

4. 경로 탭에서 생성을 클릭합니다.

5. 라우팅 규칙 섹션에서 규칙 1에 대한 작업을 수정합니다:

   규칙 1에 대한 작업을 선택합니다:

   • 규칙에서 로그 보내기를 선택하여 플랫폼 로그를 연결된 대상으로 라우팅할 수 있습니다.

   • 이 규칙과 일치하는 플랫폼 로그를 삭제하려면 규칙의 로그 삭제 대상을 선택합니다.

   포함 필터를 추가하여 규칙에 지정된 대상으로 라우팅되는 플랫폼 로그를 결정합니다.

   • 조건을 선택하고 포함 필터가 일치시킬 위치 값을 지정합니다.

   • 여러 개의 포함 필터를 추가하려면 필터 추가를 클릭하여 필터를 추가합니다.

   목록에서 대상을 선택하여 규칙과 연결할 대상을 추가합니다. 정의된 대상이 없는 경우 대상 추가를 클릭하여 새 대상을 만듭니다.

6. 규칙 추가를 클릭하여 경로에 규칙을 추가합니다.

   라우팅 규칙의 순서는 라우팅 동작에 영향을 줍니다. 규칙은 순서대로 처리되며 하나의 규칙이 일치하면 후속 규칙은 처리되지 않습니다.

   라우팅 규칙의 순서는 각 규칙 정의의 오른쪽에 있는 위쪽 및 아래쪽 화살표를 클릭하여 변경할 수 있습니다.

   규칙 또는 필터를 제거해야 하는 경우 규칙 또는 필터와 연결된 제거 아이콘을 클릭합니다.

   라우트당 최대 10개의 규칙을 구성할 수 있습니다.

7. 다음 을 클릭하십시오.

8. 경로의 이름을 입력합니다.

9. 경로 정의를 검토하여 규칙의 순서가 의도한 대로 되어 있는지 확인합니다.

   자세한 내용은 라우팅 우선순위 이해를 참조하세요.

10. 작성을 클릭하십시오.

UI를 사용하여 경로 업데이트하기

UI를 사용하여 경로를 업데이트하려면 다음 단계를 완료하세요.

1. IBM Cloud 계정에 로그인 합니다.

2. 메뉴 아이콘 > 관측성을 클릭하십시오.

3. 로깅 > 라우팅을 클릭합니다.

4. 경로 탭에서 업데이트할 경로를 결정하고 클릭합니다.

5. 경로 이름을 바꾸려면 이름 바꾸기를 클릭합니다.

6. 편집을 클릭하여 경로 규칙을 업데이트합니다.

   라우팅 규칙에서 규칙의 작업을 수정합니다:

   • 플랫폼 로그를 연결된 대상으로 라우팅하는 규칙에 대해 Send 을 선택합니다.

   • 이 규칙과 일치하는 플랫폼 로그를 삭제하려면 규칙에 대해 Drop 을 선택합니다.

   포함 필터를 추가하거나 수정하여 규칙에 지정된 대상으로 라우팅되는 플랫폼 로그를 결정합니다.

   원하는 필터와 조건을 선택하고 포함 필터로 일치시킬 값을 지정합니다.

   여러 개의 포함 필터를 추가하려면 필터 추가를 클릭하여 필터를 추가합니다.

7. 목록에서 대상을 선택하여 규칙과 연결할 대상을 수정합니다. 정의된 타겟이 없는 경우 타겟 추가를 클릭하여 새 타겟을 만듭니다.

8. 규칙 추가를 클릭하여 경로에 규칙을 추가합니다.

   라우팅 규칙의 순서는 라우팅 동작에 영향을 줍니다. 규칙은 순서대로 처리되며 하나의 규칙이 일치하면 후속 규칙은 처리되지 않습니다.

   라우팅 규칙의 순서는 각 규칙 정의의 오른쪽에 있는 위쪽 및 아래쪽 화살표를 클릭하여 변경할 수 있습니다.

   규칙 또는 필터를 제거해야 하는 경우 규칙 또는 필터와 연결된 제거 아이콘을 클릭합니다.

   라우트당 최대 10개의 규칙을 구성할 수 있습니다.

9. 경로를 변경하려면 업데이트를 클릭합니다.

UI를 사용하여 경로 보기

UI를 사용하여 경로를 보려면 다음 단계를 완료하세요.

1. IBM Cloud 계정에 로그인 합니다.

2. 메뉴 아이콘 > 관측성을 클릭하십시오.

3. 로깅 > 라우팅을 클릭합니다.

4. 경로 탭에서 구성된 경로 목록을 볼 수 있습니다.

   경로의 순서는 독립적으로 처리되므로 라우팅 동작에 영향을 미치지 않습니다.

   각 경로에는 경로 이름과 규칙이 표시됩니다.

   라우팅 페이지에는 라우팅 구성에 대한 추가 정보가 포함된 라우팅 안내도 표시됩니다.

UI를 사용하여 라우트 삭제

UI를 사용하여 경로를 삭제하려면 다음 단계를 완료하세요.

1. IBM Cloud 계정에 로그인 합니다.

2. 메뉴 아이콘 > 관측성을 클릭하십시오.

3. 로깅 > 라우팅을 클릭합니다.

4. 경로 탭에서 삭제할 경로를 결정하고 클릭합니다.

5. 전체 경로를 삭제하려면 삭제를 클릭합니다. 경로를 삭제하기 전에 경로 이름을 입력해야 합니다.

CLI 전제조건

CLI를 사용하여 경로를 관리하기 전에 다음 단계를 완료하세요:

1. IBM Cloud CLI를 설치하십시오.

2. IBM Cloud Logs Routing CLI를 설치하십시오.

3. IBM Cloud에 로그인하십시오. ibmcloud login 명령을 실행하십시오.

CLI를 사용하여 라우트 작성

이 명령을 사용하여 경로를 생성합니다.

경로 이름은 계정에서 고유합니다.

ibmcloud logs-router route create --name NAME --rules RULES | @RULES-FILE [--output FORMAT] [--force]

ibmcloud logs-router route create --name route3 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]}]'

Id           cfa2be32-979d-4e99-a2a2-e68e65e9b8cc
Name         route3
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T12:59:25.764Z
Updated At   2026-04-29T12:59:25.764Z
Managed By   account

ibmcloud logs-router route create --name route4 --rules '[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "in", "values": ["us-south","eu-de"]}]},{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80"}],"inclusion_filters": [{"operand": "location", "operator": "is", "values": ["us-east"]}]}]'

Id           6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name         route4
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


             action              send
             inclusion_filters
                                 operand    location
                                 operator   is
                                 values     [us-east]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T13:01:11.685Z
Updated At   2026-04-29T13:01:11.685Z
Managed By   account

CLI를 사용하여 라우트 업데이트

이 명령을 사용하여 경로를 업데이트합니다. 라우트가 원래 작성되었던 때와는 다르게 지정된 값이 명령에 지정된 값으로 업데이트됩니다.

ibmcloud logs-router route update --id ROUTE [--name NAME] [--rules RULES | @RULES-FILE] [--output FORMAT] [--force]

Id           6bb85c44-7187-4e45-b850-c912ddd2d0bf
Name         my-new-route-name
Rules
             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [us-south, eu-de]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


             action              send
             inclusion_filters
                                 operand    location
                                 operator   is
                                 values     [us-east]

             targets
                                 id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                                 name          cl-target2
                                 target_type   cloud-logs

                                 id            6f9137b3-2bb9-4724-851b-153e23c82d80
                                 name          cl-platform-logs-sydney-113
                                 target_type   cloud-logs


Created At   2026-04-29T13:01:11.685Z
Updated At   2026-04-29T13:07:32.677Z
Managed By   account

CLI를 사용하여 라우트 삭제

이 명령을 사용하여 경로를 삭제할 수 있습니다.

ibmcloud logs-router route delete --id route [--force]

Are you sure you want to delete? [y/n]> y
OK

CLI를 사용하여 경로에 대한 정보 얻기

이 명령을 사용하여 IBM Cloud Logs Routing 지역의 라우트에 대한 정보를 얻으십시오.

ibmcloud logs-router route get --id route [--output FORMAT]

Id           2a4739ee-7cd6-4e05-b60d-9b2e7b0b7981
Name         route2
Rules
             action    send
             targets
                       id            0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7
                       name          cl-target2
                       target_type   cloud-logs

                       id            6f9137b3-2bb9-4724-851b-153e23c82d80
                       name          cl-platform-logs-sydney-113
                       target_type   cloud-logs


Created At   2026-04-29T12:55:23.106Z
Updated At   2026-04-29T12:55:23.106Z
Managed By   account

지역에서 모든 라우트 나열

이 명령을 사용하여 IBM Cloud Logs Routing 지역에 대해 구성된 경로를 나열합니다.

ibmcloud logs-router route list [--output FORMAT]

API 라우트 및 조치

다음 표에는 라우트를 관리하는 데 실행할 수 있는 조치가 나열되어 있습니다.

사설 및 공용 엔드포인트를 사용하여 라우트를 관리할 수 있습니다. 사용 가능한 ENDPOINTS 목록에 대한 자세한 정보는 엔드포인트를 참조하십시오.

• 다음 형식의 API 엔드포인트를 사용하여 비공개 네트워크에서 경로를 관리할 수 있습니다: https://api.private.REGION.logs-router.cloud.ibm.com
• 다음 형식의 API 엔드포인트를 사용하여 공용 네트워크에서 경로를 관리할 수 있습니다: https://api.REGION.logs-router.cloud.ibm.com

계정 설정을 업데이트하여 공용 엔드포인트를 사용 안함으로 설정할 수 있습니다. 자세한 내용은 경로 및 지역 설정 구성을 참조하세요.

REST API에 대한 자세한 내용은 경로를 참조하세요.

API 전제조건

라우트를 관리하기 위해 API 호출을 수행하려면 다음 단계를 완료하십시오.

1. IAM 액세스 토큰을 가져오십시오. 자세한 정보는 IAM 액세스 토큰 검색을 참조하십시오.
2. 라우트를 구성 또는 관리할 지역에서 API 엔드포인트를 식별하십시오. 자세한 정보는 엔드포인트를 참조하십시오.

API를 사용하여 라우트 작성

다음과 같은 cURL 명령을 사용하여 라우트를 작성할 수 있습니다.

경로 이름은 계정에서 고유합니다. 경로 이름을 재사용하여 여러 목적지를 구성할 수 없습니다.

curl -X POST <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "ROUTE_NAME",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "50375218-7cff-4234-bbb4-171bebab8408"
          },
          {
            "id": "c7519d8a-5f97-498b-a229-8542f60955cd"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          }
        ]
      }
    ]
  }'

여기서,

<ENDPOINT>

경로를 구성하거나 관리하려는 지역의 API 엔드포인트입니다. 자세한 정보는 엔드포인트를 참조하십시오.

ROUTE_NAME

라우트에 지정되는 이름입니다.

라우트에 지정되는 이름입니다.

최대 길이는 1000자입니다.

최소 길이는 1자입니다.

이름에는 공백, -, ., _, : 이외의 특수 문자를 포함할 수 없습니다.

자원 이름에 개인 식별 정보(PII)를 포함하지 마십시오.

RULES

플랫폼 로그가 라우팅되는 방식을 정의하는 @ 접두사가 붙은 JSON 파일 경로 또는 JSON 문자열입니다.

규칙은 구성된 순서대로 평가됩니다.

최대 길이는 10개의 규칙입니다.

자세한 내용은 라우팅 규칙 정의하기를 참조하세요.

예를 들어 다음 cURL 요청을 사용하여 경로를 만들 수 있습니다:

curl -X POST https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My-route",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
          },
          {
            "id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          },
          {
            "operand": "service_name",
            "operator": "in",
            "values": ["codeengine","container-registry"]
          }
        ]
      }
    ]
  }'

출력은 다음과 같습니다.

{"id":"c7673f63-1260-4f86-bc1a-aaedb89391d8","name":"route5","crn":"crn:v1:bluemix:public:logs-router:global:a/xxxxxxx::route:c7673f63-1260-4f86-bc1a-aaedb89391d8","rules":[{"action":"send","targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","name":"cl-target2","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7","target_type":"cloud-logs"},{"id":"6f9137b3-2bb9-4724-851b-153e23c82d80","name":"cl-platform-logs-sydney-113","crn":"crn:v1:bluemix:public:logs-router:eu-gb:a/xxxxxxx::target:6f9137b3-2bb9-4724-851b-153e23c82d80","target_type":"cloud-logs"}],"inclusion_filters":[{"operand":"location","operator":"is","values":["us-east"]}]}],"managed_by":"account","created_at":"2026-04-29T13:26:34.237Z","updated_at":"2026-04-29T13:26:34.237Z"}

API를 사용하여 라우트 업데이트

경로의 이름과 규칙을 수정할 수 있습니다. 경로가 처음 생성되었을 때와 다른 지정된 값은 요청에 지정된 값으로 업데이트됩니다.

라우트를 업데이트하는 경우 요청의 데이터 섹션에 라우트 정보를 포함해야 합니다.

• 모든 필드를 전달해야 합니다.
• 변경해야 하는 필드를 업데이트하십시오.

경로 이름은 계정에서 고유합니다. 경로 이름을 재사용하여 여러 목적지를 구성할 수 없습니다.

다음과 같은 cURL 명령을 사용하여 라우트를 업데이트할 수 있습니다.

curl -X PATCH <ENDPOINT>/v3/routes/ROUTE_ID -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "ROUTE_NAME",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "d3ebcda8-953d-45ea-a4a7-b47f8c4a9742"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["eu-de"]
          }
        ]
      }
    ]
  }'

여기서,

<ENDPOINT>

경로를 구성하거나 관리하려는 지역의 API 엔드포인트입니다. 자세한 정보는 엔드포인트를 참조하십시오.

ROUTE_ID

경로의 ID.

ROUTE_NAME

라우트에 지정되는 이름입니다.

라우트에 지정되는 이름입니다.

최대 길이는 1000자입니다.

최소 길이는 1자입니다.

이름에는 공백, -, ., _, : 이외의 특수 문자를 포함할 수 없습니다.

자원 이름에 개인 식별 정보(PII)를 포함하지 마십시오.

RULES

플랫폼 로그가 라우팅되는 방식을 정의하는 @ 접두사가 붙은 JSON 파일 경로 또는 JSON 문자열입니다.

규칙은 구성된 순서대로 평가됩니다.

최대 길이는 10개의 규칙입니다.

자세한 내용은 라우팅 규칙 정의하기를 참조하세요.

예를 들어 다음 cURL 요청을 사용하여 달라스에서 경로를 만들 수 있습니다:

curl -X PATCH https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json" -d '{
    "name": "My new route name",
    "rules": [
      {
        "action": "send",
        "targets": [
          {
            "id": "0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"
          },
          {
            "id": "6f9137b3-2bb9-4724-851b-153e23c82d80"
          }
        ],
        "inclusion_filters": [
          {
            "operand": "location",
            "operator": "is",
            "values": ["us-east"]
          }
        ]
      }
    ]
    }
  }'

API를 사용하여 라우트 삭제

다음과 같은 cURL 명령을 사용하여 라우트를 삭제할 수 있습니다.

curl -X DELETE <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

여기서,

<ENDPOINT>

경로를 구성하거나 관리하려는 지역의 API 엔드포인트입니다. 자세한 정보는 엔드포인트를 참조하십시오.

<route_ID>

경로의 ID.

예를 들어 다음 cURL 요청을 사용하여 ID가 c7673f63-1260-4f86-bc1a-aaedb89391d8 인 경로를 삭제할 수 있습니다:

curl -X DELETE https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

API를 사용하여 라우트 보기

다음 cURL 명령을 사용하여 1개의 경로에 대한 구성 세부 정보를 볼 수 있습니다:

curl -X GET <ENDPOINT>/v3/routes/<route_ID> -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

여기서,

<ENDPOINT>

경로를 구성하거나 관리하려는 지역의 API 엔드포인트입니다. 자세한 정보는 엔드포인트를 참조하십시오.

<route_ID>

경로의 ID.

예를 들어, 다음의 cURL 요청을 실행하여 ID가 00000000-0000-0000-0000-000000000000인 라우트에 대한 정보를 얻을 수 있습니다.

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes/c7673f63-1260-4f86-bc1a-aaedb89391d8 -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

API를 사용하여 모든 경로 나열하기

다음과 같은 cURL 명령을 사용하여 모든 라우트를 볼 수 있습니다.

curl -X GET <ENDPOINT>/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

여기서,

• <ENDPOINT>는 라우트를 구성하거나 관리할 지역의 API 엔드포인트입니다. 자세한 정보는 엔드포인트를 참조하십시오.

예를 들어 다음 cURL 요청을 실행하여 달라스에 정의된 경로에 대한 정보를 얻을 수 있습니다:

curl -X GET https://api.us-south.logs-router.cloud.ibm.com/v3/routes -H "Authorization: $ACCESS_TOKEN" -H "content-type: application/json"

HTTP 응답 코드

IBM Cloud Logs Routing REST API를 사용하는 경우 표준 HTTP 응답 코드를 가져와서 메소드가 완료되었는지 여부를 표시할 수 있습니다.

• 200 응답은 항상 성공을 나타냅니다.
• 4xx 응답은 실패를 나타냅니다.
• 5xx 응답은 내부 시스템 오류를 나타냅니다.

일부 HTTP 응답 코드는 다음 표를 참조하십시오.