다음을 통해 공유


Azure Monitor Log Analytics 진단 설정을 사용하여 Azure Cosmos DB 데이터 모니터링

적용 대상: NoSQL MongoDB Cassandra Gremlin 테이블

Azure의 진단 설정은 리소스 로그를 수집하는 데 사용됩니다. 리소스는 Azure 리소스 로그를 내보내고, 해당 리소스의 작업에 대한 풍부하고 빈도 높은 데이터를 제공합니다. 이러한 로그는 요청별로 캡처되며 데이터 평면 로그라고도 불립니다. 데이터 평면 작업의 몇 가지 예로는 delete, insert 및 readFeed가 있습니다. 이러한 로그의 내용은 리소스 종류에 따라 달라집니다.

진단 설정에 대해 자세히 알아보려면 Azure Monitor의 진단 설정을 참조하세요.

참고 항목

REST API 탭의 지침에 따라 테이블용 API를 제외한 모든 API에 대해 특정 리소스 모드에서 진단 설정을 만드는 것이 좋습니다. 이 옵션은 데이터 처리를 위한 향상된 보기를 통해 추가 비용 최소화를 이끌어 냅니다.

필수 조건

Warning

리소스를 삭제, 변경, 이동하거나 리소스 그룹 또는 구독 간에 마이그레이션해야 하는 경우 먼저 해당 진단 설정을 삭제합니다. 그렇지 않으면 이 리소스를 다시 만들 때 삭제된 리소스에 대한 진단 설정이 각 리소스의 리소스 구성에 따라 새 리소스에 포함될 수 있습니다. 진단 설정이 새 리소스에 포함된 경우 진단 설정에 정의된 대로 리소스 로그 컬렉션을 다시 시작하고 해당 메트릭 및 로그 데이터를 이전에 구성된 대상으로 보냅니다.

또한 삭제할 리소스에 대한 진단 설정은 삭제하고 환경을 깨끗하게 유지하기 위해 다시 사용하지 않는 것이 좋습니다.

진단 설정 만들기

여기서는 계정에 대한 진단 설정을 만드는 프로세스를 안내합니다.

참고 항목

로그를 범주로 내보내는 메트릭은 현재 지원되지 않습니다.

  1. Azure Portal에 로그인합니다.

  2. 기존 Azure Cosmos DB 계정으로 이동합니다.

  3. 리소스 메뉴의 모니터링 섹션에서 진단 설정을 선택합니다. 그런 다음 진단 설정 추가 옵션을 선택합니다.

    새 항목을 만들거나 기존 항목을 편집하는 옵션이 포함된 진단 설정 목록의 스크린샷.

    Important

    전체 텍스트 쿼리 기능이 계정에서 사용하도록 설정되지 않은 경우 “전체 텍스트 쿼리를 사용하도록 설정[...]”이라는 메시지가 표시될 수 있습니다. 이 기능을 사용하지 않으려면 이 경고를 무시해도 됩니다. 자세한 내용은 전체 텍스트 쿼리 사용을 참조하세요.

  4. 진단 설정 창에서 설정 이름을 example-setting으로 지정한 다음 QueryRuntimeStatistics 범주를 선택합니다. Log Analytics 작업 영역으로 보내기 확인란을 사용하도록 설정하고 기존 작업 영역을 선택합니다. 마지막으로 대상 옵션으로 특정 리소스를 선택합니다.

    진단 설정을 구성하기 위한 다양한 옵션의 스크린샷.

쿼리 텍스트 로깅에 전체 텍스트 쿼리 사용

Azure Cosmos DB는 자세한 문제 해결을 위한 고급 로깅을 제공합니다. 전체 텍스트 쿼리를 사용하도록 설정하면, Azure Cosmos DB 계정 내의 모든 요청에 대해 난독 분석된 쿼리를 볼 수 있습니다. 또한 Azure Cosmos DB가 로그에 이 데이터에 액세스하고 이 데이터를 표면화할 수 있는 권한을 부여합니다.

Warning

이 기능을 사용하도록 설정하면 추가 로깅 비용이 발생할 수 있습니다. 가격 세부 정보는 Azure Monitor 가격을 참조하세요. 문제 해결 후 이 기능을 사용하지 않도록 설정하는 것이 좋습니다.

  1. 기존 Azure Cosmos DB 계정 페이지에서 리소스 메뉴의 설정 섹션에 있는 기능 옵션을 선택합니다. 그런 다음 진단 전체 텍스트 쿼리 기능을 선택합니다.

    Azure Cosmos DB 계정에 사용할 수 있는 기능의 스크린샷.

  2. 대화 상자에서 Enable을 선택합니다. 이 설정은 몇 분 내에 적용됩니다. 이제 새로 검색된 모든 로그에는 각 요청에 대한 전체 텍스트 또는 PIICommand 텍스트가 있습니다.

    Azure Cosmos DB 계정에 대해 사용하도록 설정되는 진단 전체 텍스트 쿼리 기능의 스크린샷.