마이그레이션 가이드: v1 에서 v3

이 가이드는 IBM Cloud Logs Routing 서비스를 버전 1( v1 )에서 버전 3( v3 )으로 마이그레이션하기 위한 단계별 지침을 제공합니다. v1 은 지역별 개념을 제공하는 반면, v3 은 필요에 따라 플랫폼 로그의 라우팅을 조정할 수 있는 경로 및 필터를 통해 글로벌 접근 방식을 제공합니다. 마이그레이션 프로세스에는 새로운 v3 환경을 구성한 다음 v1 에서 v3 로 전환하는 작업이 포함됩니다.

최종 마이그레이션 단계에서는 플랫폼 로그가 수신되지 않아 서비스가 잠시(약 몇 분) 중단될 수 있다는 점에 유의하세요.

경고: 이 마이그레이션은 되돌릴 수 없습니다. v3 로 마이그레이션한 후에는 v1 으로 다시 이동할 수 없습니다.

일반적인 마이그레이션 시나리오

마이그레이션을 시작하기 전에 현재 로깅 아키텍처에 가장 적합한 시나리오가 무엇인지 파악하는 것이 중요합니다. 다음 세 가지 시나리오는 가장 일반적인 로깅 구성을 나타내며 v3 환경에 적합한 설정을 결정하는 데 도움이 됩니다.

시나리오 1: 중앙 집중식 로깅

중앙 집중식 로깅 구성에서는 전체 계정에 대한 모든 플랫폼 로그가 단일 IBM Cloud Logs 인스턴스로 통합됩니다.

이 접근 방식은 계정 전반의 모든 플랫폼 활동에 대한 통합 보기를 제공하여 로그 관리를 간소화합니다.

v3 에서 이 시나리오를 구현하려면 중앙 집중식 IBM Cloud Logs 인스턴스를 가리키는 하나의 대상을 만들고 소스 지역에 관계없이 모든 플랫폼 로그를 캡처하도록 와일드카드 규칙으로 하나의 경로를 구성해야 합니다.

시나리오 2: 지리적 로깅

지리적 로깅 시나리오는 여러 지리적 위치에 분산된 여러 로깅 인스턴스를 유지하는 조직을 위해 설계되었습니다.

이 구성에서는 여러 지역의 플랫폼 로그가 지리적 근접성 또는 데이터 상주 요건에 따라 가장 가까운 지역 또는 지정된 지역 IBM Cloud Logs 인스턴스로 라우팅됩니다. 이 접근 방식은 중앙 집중식 가시성과 지리적 분포의 균형을 유지하여 여러 지역의 로그를 전략적으로 위치한 소수의 IBM Cloud Logs 인스턴스로 라우팅할 수 있습니다.

이 시나리오를 구현하려면 여러 대상(각 지역 IBM Cloud Logs 인스턴스당 하나씩)을 만들고 적절한 지역 기반 필터로 경로를 구성하여 로그를 올바른 지역 대상으로 보내도록 해야 합니다.

시나리오 3: 지역별 로깅

지역별 로깅은 가장 분산된 접근 방식으로, 각 IBM Cloud 지역마다 전용 IBM Cloud Logs 인스턴스가 있습니다.

이 구성은 로그 데이터의 완전한 지역 격리를 보장하며 엄격한 데이터 보존 또는 규정 준수 요구 사항을 충족하는 데 자주 사용됩니다. 이 시나리오에서는 특정 지역에서 생성된 플랫폼 로그가 동일한 지역에 배포된 IBM Cloud Logs 인스턴스로만 라우팅됩니다.

v3 에서 이 시나리오를 구현하려면 운영하는 각 지역에 대해 별도의 대상과 경로를 만들고 각 지역 경로에 해당 지역의 IBM Cloud Logs 인스턴스로만 로그 라우팅을 제한하는 필터가 포함되어 있는지 확인해야 합니다.

마이그레이션 접근 방식

v1 에서 v3 으로 마이그레이션하는 방법에는 두 가지가 있습니다. 필요에 가장 적합한 접근 방식을 선택하세요.

  1. 자동 마이그레이션(권장):

    자동 마이그레이션 방식은 마이그레이션 프로세스를 간소화하고 구성 오류의 위험을 줄여주므로 대부분의 사용자에게 권장됩니다.

    마이그레이션 API를 사용하여 기존 v1 테넌트를 기반으로 v3 대상 및 경로를 자동으로 생성하세요.

    자세한 내용은 자동 마이그레이션을 참조하세요.

  2. 수동 구성:

    마이그레이션을 완료하기 전에 v3 환경을 처음부터 수동으로 구성합니다.

    다음 옵션 중 하나를 선택하십시오.

마이그레이션 상태 이해

마이그레이션 프로세스는 여러 단계를 거쳐 진행됩니다:

  • BEFORE: 마이그레이션이 시작되기 전의 초기 상태입니다. 이전 마이그레이션 시도가 실패한 경우 오류 메시지가 포함됩니다.
  • IN_PROGRESS: 마이그레이션 프로세스가 활발하게 실행 중입니다. 구성에 따라 몇 분 정도 걸릴 수 있습니다.
  • PENDING_COMPLETION: v3 경로 및 대상이 성공적으로 생성되었습니다. 마이그레이션을 완료하기 전에 구성을 확인해야 합니다.
  • 완료: 마이그레이션이 성공적으로 완료되었으며 이제 계정이 v3 구성을 사용하고 있습니다.

마이그레이션을 위한 IAM 권한

마이그레이션 프로세스에는 특정 IAM 권한이 필요합니다. 마이그레이션을 관리하는 데 사용할 수 있는 글로벌 작업은 다음과 같습니다:

  • logs-router.migration.post: 마이그레이션을 구성하고 시작합니다. 계정 메타데이터를 설정한 다음 모든 지역의 실제 업데이트를 시작하는 2단계 프로세스입니다. 관리자 역할이 필요합니다.
  • logs-router.migration.get: 마이그레이션 상태를 검색합니다. 관리자, 편집자, 운영자 및 뷰어 역할에 사용할 수 있습니다.
  • logs-router.migration.delete: 자동으로 생성된 모든 v3 대상 및 경로를 포함하여 생성된 마이그레이션 계획을 삭제합니다. 관리자 역할이 필요합니다.

V1 에서 V3 로 마이그레이션하려면 관리자 플랫폼 역할이 있어야 합니다.

IAM 역할 및 권한에 대한 자세한 내용은 IAM 역할을 참조하세요.