시작하기 전에

1. IBM Cloud 계정이 없는 경우 IBM Cloud 계정을 등록하세요. IBM Cloud에서 작업하려면 IBMid가 필요합니다.

2. IBM Cloud Logs Routing 서비스를 사용할 수 있는 지역을 확인하십시오.

3. IBM Cloud® 계정에 대해 IBM Cloud Logs Routing 을 구성하는 사용자에게 IBM Cloud Logs Routing 서비스를 관리할 수 있는 충분한 권한이 있는지 확인합니다. 자세한 내용은 다음에 대한 IAM 액세스 관리 IBM Cloud Logs Routing 을 참조하세요.

   리소스를 관리하려면 플랫폼 역할 관리자가 필요합니다.

4. 다음 도구를 설치합니다:

   • IBM Cloud® CLI를 다운로드하여 설치하십시오.

   • 출력을 처리하고 원하는 결과를 쿼리하려면 jq를 다운로드하여 설치하세요.

5. 프로비저닝 또는 IBM Cloud Logs 인스턴스에 대한 액세스 권한이 있습니다. 자세한 정보는 인스턴스 프로비저닝을 참조하십시오.

서비스 대 서비스 권한 부여 서비스 만들기

IBM Cloud® Identity and Access Management (IAM)을 사용하여 IBM Cloud Logs Routing 액세스 권한을 IBM Cloud Logs 부여하는 권한을 생성해야 IBM Cloud Logs Routing 서비스가 IBM Cloud Logs 인스턴스 대상(타겟)으로 로그를 보낼 수 있습니다.

서비스 권한 부여를 위해 서비스를 구성하기 전에 IBM Cloud Logs 에 대한 발신자 역할이 있어야 합니다.

다음 단계를 완료하십시오.

1. IBM Cloud 콘솔에서 관리 > **액세스(IAM)**를 클릭하고 권한을 선택하십시오.

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

3. 소스 계정을 구성합니다. 이 계정을 선택합니다.

4. 로그 라우팅을 소스 서비스로 선택합니다. 그런 다음 액세스 범위를 모든 리소스로 설정합니다.

5. 대상 서비스로 클라우드 로그를 선택합니다. 그런 다음 액세스 범위를 모든 리소스로 설정하여 모든 IBM Cloud Logs 인스턴스에 대한 액세스 권한을 부여하거나 선택한 속성을 기반으로 리소스 > 서비스 인스턴스를 구성하여 단일 인스턴스에 대한 액세스 권한을 부여합니다.

   이 유형의 권한 부여에는 다른 속성이 지원되지 않습니다.

6. 서비스 액세스 섹션에서 발신자를 선택하여 대상 서비스에 액세스하는 소스 서비스에 액세스 권한을 할당합니다.

7. 권한 부여를 클릭하십시오.

자세한 내용은 IBM Cloud Logs 으로 로그를 보낼 수 있는 액세스 권한을 부여하기 위한 S2S 권한 만들기를 참조하세요.

기본 메타데이터 위치 및 API 버전 구성하기

다음 단계를 완료하십시오.

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

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

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

4. 설정 탭을 클릭하십시오.

5. 변경할 설정 옆의 편집을 클릭합니다.

   기본 메타데이터 위치를 입력합니다.

   API 버전을 3 로 설정합니다.

대상 작성

다음 단계를 완료하여 대상을 만듭니다:

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

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

3. 로깅 > 라우팅을 선택합니다.

4. 대상 섹션에서 만들기를 클릭하여 만들기 패널을 엽니다.

5. 대상 선택에서 인스턴스로 검색 또는 CRN 지정을 선택합니다.

   인스턴스로 검색을 선택하여 계정에서 사용할 수 있는 표에서 IBM Cloud Logs 인스턴스를 선택합니다

   다른 계정에 있는 인스턴스의 IBM Cloud Logs 인스턴스 CRN을 추가하려면 CRN 지 정을 선택합니다.

6. 대상 세부 정보 섹션에서 다음 작업을 완료합니다:

   대상 이름을 입력합니다.

   설정되지 않음 토글을 활성화하여 IBM Cloud Logs Routing 설정에서 새 대상을 기본 대상으로 자동 설정합니다.

7. 대상 생성을 클릭합니다.

경로 구성

다음 단계를 완료하여 대상을 만듭니다:

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

로그가 대상 대상으로 전송되었는지 확인하기

로그가 IBM Cloud Logs 인스턴스로 라우팅되는지 확인합니다.

다음 단계를 완료하십시오.

1. 리전에서 플랫폼 로그를 수집할 대상으로 구성된 IBM Cloud Logs 인스턴스에 대한 IBM Cloud Logs 웹 UI를 실행합니다. 이것은 대상을 설정하는 단계에서 선택한 인스턴스입니다.

2. 사용자 지정 보기를 통해 로그를 봅니다. 자세한 정보는 로그 보기를 참조하십시오.

   모든 플랫폼 로그는 JSON으로 생성됩니다. 인스턴스의 플랫폼 로그 값을 applicationName 으로 선택하거나 Lucene 쿼리를 실행하여 플랫폼 로그를 필터링할 수 있습니다: coralogix.metadata.applicationName:"ibm-platform-logs"