HTTP Data Collector API에서 Log Ingestion API로 마이그레이션하여 Azure Monitor 로그로 데이터 보내기

Azure Monitor 로그 수집 API는 레거시 HTTP 데이터 수집기 API보다 더 많은 처리 능력과 보다 유연한 로그 수집 및 테이블 관리 기능을 제공합니다. 이 문서에서는 데이터 수집기 API와 로그 수집 API 간의 차이점을 설명하고 새 로그 수집 API로 마이그레이션하기 위한 지침과 모범 사례를 제공합니다.

로그 수집 API의 이점

로그 수집 API는 데이터 수집기 API에 비해 다음과 같은 이점을 제공합니다.

• 필터링 및 데이터 조작을 포함하여 대상 테이블에 수집되기 전에 데이터를 수정할 수 있는 변환을 지원합니다.
• 여러 대상으로 데이터를 보낼 수 있습니다.
• 열 이름을 비롯한 대상 테이블 스키마, 원본 데이터 스키마가 변경될 때 대상 테이블에 새 열을 추가할지 여부를 관리할 수 있습니다.

필수 조건

이 문서에 설명된 마이그레이션 절차에서는 다음이 있다고 가정합니다.

• 최소한 기여자 권한이 있는 Log Analytics 작업 영역.
• Log Analytics 작업 영역에서 데이터 수집 규칙을 만들 수 있는 권한
• API 호출을 인증할 Microsoft Entra 애플리케이션 또는 다른 Resource Manager 인증 체계

필수 사용 권한

로그 수집 API에 필요한 새 리소스 만들기

로그 수집 API를 사용하려면 HTTP 데이터 수집기 API에 필요하지 않은 두 가지 새로운 유형의 리소스를 만들어야 합니다.

• 수집한 데이터가 처리를 위해 파이프라인으로 수집되는 데이터 수집 엔드포인트
• 데이터 변환과 데이터가 수집되는 대상 테이블을 정의하는 데이터 수집 규칙

기존 사용자 지정 테이블 마이그레이션 또는 새 테이블 만들기

현재 데이터 수집기 API를 사용하여 데이터를 보내는 기존 사용자 지정 테이블이 있는 경우 다음을 수행할 수 있습니다.

• 로그 수집 API를 사용하여 동일한 테이블로 데이터를 계속 수집하도록 테이블을 마이그레이션합니다.

• 기존 테이블 및 데이터를 유지하고 로그 수집 API를 사용하여 데이터를 수집하는 새 테이블을 설정합니다. 준비가 되면 이전 테이블을 삭제할 수 있습니다.

  특히 기존 테이블을 변경해야 하는 경우 이 옵션을 사용하는 것이 좋습니다. 기존 데이터 형식이 변경되고 기존 데이터 수집기 API 사용자 지정 테이블의 여러 스키마가 변경되므로 오류가 발생할 수 있습니다.

이 표에는 각 옵션에 대해 유의해야 할 고려 사항이 요약되어 있습니다.

데이터 수집기 API를 사용하는 테이블을 데이터 수집 규칙 및 로그 수집 API로 변환하려면 테이블에 대해 다음 API 호출을 실행합니다.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourcegroups/{resourceGroupName}/providers/Microsoft.OperationalInsights/workspaces/{workspaceName}/tables/{tableName}/migrate?api-version=2021-12-01-preview

이 호출은 멱등성이므로 테이블이 이미 마이그레이션된 경우에는 아무런 효과가 없습니다.

API 호출을 사용하면 테이블의 모든 DCR 기반 사용자 지정 로그 기능을 사용할 수 있습니다. 데이터 수집기 API는 기존 열에 데이터를 계속 수집하지만 새 열은 만들지 않습니다. 이전에 정의한 사용자 지정 필드는 계속 채워지지 않습니다. 기존 테이블을 데이터 수집 규칙을 사용하도록 마이그레이션하는 또 다른 방법이지만 로그 수집 API가 테이블에 작업 영역 변환을 반드시 적용하는 것은 아닙니다.

로그 수집 API 호출

로그 수집 API를 사용하면 호출당 최대 1MB의 압축되거나 압축되지 않은 데이터를 보낼 수 있습니다. 1MB 이상의 데이터를 보내야 하는 경우 여러 호출을 병렬로 보낼 수 있습니다. 이것은 데이터 수집기 API의 변경된 부분으로, 호출당 최대 32MB의 데이터를 보낼 수 있습니다.

로그 수집 API를 호출하는 방법에 대한 내용은 로그 수집 REST API 호출을 참조하세요.

원본 데이터 개체의 변경 내용에 따라 테이블 스키마 및 데이터 수집 규칙 수정

데이터 수집기 API는 원본 데이터 개체 스키마가 변경되면 대상 테이블 스키마를 자동으로 조정하지만 로그 수집 API는 그렇지 않습니다. 이렇게 하면 만들지 않으려는 열로 새 데이터가 수집되지 않습니다.

원본 데이터 스키마가 변경되면 다음을 수행할 수 있습니다.

• 원본 데이터 스키마 변경 내용에 맞게 대상 테이블 스키마 및 데이터 수집 규칙을 수정합니다.
• 대상 테이블의 기존 열로 새 데이터를 보내도록 데이터 수집 규칙의 변환을 정의합니다.
• 대상 테이블 및 데이터 수집 규칙은 변경되지 않은 상태로 둡니다. 이 경우 새 데이터를 수집하지 않습니다.

다음 단계

• Azure Portal을 사용하여 사용자 지정 로그를 보내는 자습서를 안내합니다.
• Resource Manager 템플릿과 REST API를 사용하여 사용자 지정 로그를 보내는 자습서를 안내합니다.