라우팅 규칙 정의

라우팅 규칙을 정의하려면 플랫폼 로그의 대상으로 1개 이상의 대상을 지정해야 합니다. 또한 플랫폼 로그가 해당 대상에 라우팅되는 방식에 대한 조건을 정의하는 포함 필터를 하나 이상 정의할 수도 있습니다.

계정에서 정의하는 각 경로에 대해 최대 10개의 규칙을 구성할 수 있습니다. 규칙은 지역에서 라우팅되는 플랫폼 로그와 라우팅할 위치를 지정합니다. 자세한 내용은 계정에서 경로가 작동하는 방식 이해하기를 참조하세요.

규칙은 1개의 액션, 1개 이상의 대상, 0개 이상의 포함 필터로 구성됩니다.

대상

타겟은 플랫폼 로그가 라우팅되는 타겟 ID 목록을 정의합니다.

  • 규칙당 최대 3개의 대상 ID를 지정할 수 있습니다.

  • 경로를 구성하는 동일한 지역, 다른 지역 및 다른 계정에서 사용할 수 있는 리소스에 대한 대상 ID를 정의할 수 있습니다.

예를 들어 다음과 같이 대상 목록을 정의할 수 있습니다:

"targets": [{"id":"11111111-1111-1111-1111-111111111111"},{"id":"22222222-2222-2222-2222-222222222222"}]

대상은 IBM Cloud Logs 인스턴스여야 합니다.

조치

액션은 IBM Cloud Logs Routing 경로에 플랫폼 로그를 포함할지 아니면 제외할지를 정의합니다. send 와 drop 두 가지 작업이 지원됩니다. 지정하지 않으면 기본 작업은 플랫폼 로그를 전송하는 것입니다.

send
플랫폼 로그는 라우팅 규칙에 따라 정의된 경로로 전송됩니다.
drop
플랫폼 로그가 정의된 경로로 전송될 때 라우팅 규칙에 따라 플랫폼 로그는 제외됩니다.

포함 필터

포함 필터는 규칙에 지정된 대상으로 라우팅되는 플랫폼 로그를 결정하는 데 사용되는 조건을 정의합니다.

모든 플랫폼 로그를 라우팅하려면 경로를 구성할 때 inclusion_filters 정의를 제외하세요.

포함 필터는 operand, operator, value 로 구성됩니다:

operand

피연산자는 데이터를 필터링하는 데 사용되는 대상의 속성 이름입니다. 지원되는 피연산자는 다음과 같습니다: location. 이 값은 대상 CRN에서 추출됩니다.

operator

in 와 is 의 두 가지 운영자가 지원됩니다.

in

피연산자 속성의 값은 값 목록과 비교됩니다.

최대 20개의 값을 정의할 수 있습니다.

is

피연산자 속성의 값은 단일 값과 비교됩니다.

is 을 사용하는 경우 하나의 값만 지정할 수 있습니다.

value

로그 라우팅 여부를 결정하기 위해 operand 속성과 비교할 문자열 또는 문자열 배열입니다. is operator 을 사용하는 경우 value 에는 단일 문자열이 포함되어야 합니다. in operator 을 사용하는 경우 value 은 배열에 여러 문자열을 포함할 수 있습니다.

유효한 값은 operand 에 따라 다릅니다.

location
IBM Cloud Logs Routing 를 사용할 수 있는 모든 위치

포함 필터를 구성할 때 이러한 제한 사항에 유의하세요.

  • 각 규칙에 대해 최대 7개의 포함 필터를 구성할 수 있습니다.

  • inclusion_filter.values 에 대해 최대 20개의 값을 구성할 수 있습니다.

  • inclusion_filter.values 에 구성된 각 값은 최대 100자까지 입력할 수 있습니다.

IAM 액세스

라우팅 규칙을 사용하려면 사용자에게 적절한 IAM 역할이 있어야 합니다. IAM 역할에 대한 자세한 내용은 IAM 액세스 관리하기를 참조하세요

UI를 사용하여 라우팅 규칙 정의하기

UI에서 액션 및 포함 필터 라우팅 규칙을 구성할 수 있습니다. 자세한 내용은 경로 관리하기를 참조하세요.

CLI를 사용하여 라우팅 규칙 정의하기

경로 및 포함 필터에 대한 규칙은 JSON 형식으로 정의됩니다. 규칙은 다음과 같은 방식으로 정의됩니다:

  • --rules 옵션을 사용하면 명령에 직접 정보가 JSON으로 전달됩니다.
  • --files 옵션을 사용하면 정보가 JSON 파일로 전달됩니다.

--rules 옵션을 사용하는 예제

다음 예는 --rules 옵션에 직접 규칙을 지정하는 예입니다. 이 예제에서는 us-east 의 모든 플랫폼 로그가 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7 로 라우팅됩니다. eu-de 및 eu-es 의 모든 플랫폼 로그는 6f9137b3-2bb9-4724-851b-153e23c82d80 로 라우팅됩니다.

'[{"action": "send", "targets":[{"id":"0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7"}], "inclusion_filters":[{"operand": "location","operator": "is","values": ["us-east"]}]},{"targets":[{"id":"22222222-2222-2222-2222-222222222222"},{"id":"33333333-3333-3333-3333-3333333333333"}], "inclusion_filters":[{"operand": "location","operator": "in","values": ["eu-de","eu-es"]}]}]'

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

명령의 출력은 다음과 같습니다:

Id           92f4cdb3-212c-4811-bf16-03b5449e0fb8
Name         route1
Rules
             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


             action              send
             inclusion_filters
                                 operand    location
                                 operator   in
                                 values     [eu-de, eu-es]

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


Created At   2026-04-28T22:26:38.022Z
Updated At   2026-04-28T22:26:38.022Z
Managed By   account

--file 옵션을 사용하는 예제

다음 예는 --file 옵션에 rules_def.json 라는 이름의 JSON 파일을 전달하여 규칙을 지정하는 예제입니다:

--file rules_def.json

rules_def.json 파일에는 다음이 포함됩니다:

[
  {
    "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"
          ]
        }
    ]
  }
]

API를 사용하여 라우팅 규칙 정의

대상 및 포함 필터는 rules 을 사용하여 API 호출에서 정의합니다. rules 은 JSON 구조로 정의됩니다.

예를 들어 다음 예제는 my-route 라는 이름의 경로를 만들고 us-east 리전에서 0b4e6aa9-257c-4a3a-ae42-9a36a5b3adc7 및 6f9137b3-2bb9-4724-851b-153e23c82d80 타깃으로 플랫폼 로그를 전송합니다.

curl -X POST https://api.private.<REGION>.logs-router.cloud.ibm.com/v3/routes -H "Authorization: Bearer <IAM_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"]
          }
        ]
      }
    ]
  }'

자세한 내용은 API 참조를 참조하세요