Azure AI 검색 모니터링 데이터 참조
이 문서에는 이 서비스에 대한 모든 모니터링 참조 정보가 포함되어 있습니다.
Azure AI Search에 대해 수집할 수 있는 데이터 및 사용 방법에 대한 자세한 내용은 Azure AI Search 모니터링을 참조하세요.
메트릭
이 섹션에는 이 서비스에 대해 자동으로 모은 플랫폼 메트릭이 모두 나열되어 있습니다. 이러한 메트릭은 Azure Monitor에서 지원되는 모든 플랫폼 메트릭의 전역 목록의 일부이기도 합니다.
메트릭 보존에 관한 자세한 내용은 Azure Monitor 메트릭 개요를 참조하세요.
Microsoft.Search/searchServices에 대해 지원되는 메트릭
다음 표에서는 Microsoft.Search/searchServices 리소스 종류에 사용할 수 있는 메트릭을 나열합니다.
- 모든 테이블에 모든 열이 있는 것은 아닙니다.
- 일부 열은 페이지의 보기 영역 밖에 있을 수 있습니다. 사용 가능한 모든 열을 보려면 테이블 확장을 선택합니다.
테이블 제목
- 범주 - 메트릭 그룹 또는 분류입니다.
- 메트릭 - Azure Portal에 표시되는 메트릭 표시 이름입니다.
- REST API의 이름 - REST API에서 참조되는 메트릭 이름입니다.
- 단위 - 측정 단위입니다.
- 집계 - 기본 집계 형식입니다. 유효한 값은 평균(Avg), 최소(Min), 최대(Max), 합계(Sum), 개수입니다.
- 차원 - 메트릭에 사용할 수 있는 차원입니다.
- 시간 조직 - 메트릭이 샘플링되는 간격입니다. 예를 들어,
PT1M은 메트릭이 1분마다,PT30M은 30분마다,PT1H는 1시간마다 샘플링됨을 나타냅니다. - DS 내보내기- 진단 설정을 통해 메트릭을 Azure Monitor 로그로 내보낼 수 있는지 여부를 나타냅니다. 메트릭 내보내기에 대한 자세한 내용은 Azure Monitor의 진단 설정 생성을 참조하세요.
| 메트릭 | REST API의 이름 | 단위 | 집계 | 차원 | 시간 조직 | DS 내보내기 |
|---|---|---|---|---|---|---|
| 문서 처리된 개수 처리된 문서 수 |
DocumentsProcessedCount |
Count | 합계, 개수 | DataSourceName, Failed, IndexerName, IndexNameSkillsetName |
PT1M | 예 |
| 검색 대기 시간 검색 서비스에 대한 평균 검색 대기 시간 |
SearchLatency |
초 | 평균 | <없음> | PT1M | 예 |
| 초당 쿼리 검색 검색 서비스에 대한 초당 검색 쿼리 |
SearchQueriesPerSecond |
초당 개수 | 평균 | <없음> | PT1M | 예 |
| 기술 실행 호출 수 기술 실행 수 |
SkillExecutionCount |
Count | 합계, 개수 | DataSourceName, Failed, IndexerName, SkillName, SkillsetNameSkillType |
PT1M | 예 |
| 제한된 검색 쿼리 백분율 검색 서비스에 대해 제한된 검색 쿼리의 백분율 |
ThrottledSearchQueriesPercentage |
백분율 | 평균 | <없음> | PT1M | 예 |
SearchQueriesPerSecond는 검색 서비스에 대한 QPS(초당 검색 쿼리 수)의 평균을 보여 줍니다. 일반적으로 쿼리는 밀리초 단위로 실행되므로 초 단위로 측정되는 쿼리만 QPS와 같은 메트릭에 표시됩니다. 최솟값은 해당 분 동안 등록된 초당 쿼리 수의 가장 낮은 값입니다. 최대값은 가장 높은 값입니다. 평균은 전체 분에 대한 집계입니다.
예를 들어, 1분 내에 다음과 같은 패턴을 발견할 수 있습니다. SearchQueriesPerSecond에 대한 최대 로드 1초, 이후 평균 로드 58초, 그리고 마지막으로 최소값인 한 개의 쿼리만 있는 1초가 이어집니다.
메트릭 차원
메트릭 차원에 대한 자세한 내용은 다차원 메트릭을 참조하세요.
Azure AI Search에는 실행된 문서 또는 기술 수, "문서 처리된 개수" 및 "기술 실행 호출 수"를 캡처하는 메트릭과 연결된 차원이 다음과 같습니다.
| 차원 이름 | 설명 |
|---|---|
| DataSourceName | 인덱서 실행 중에 사용되는 명명된 데이터 원본 연결입니다. 유효한 값은 지원되는 데이터 원본 유형 중 하나입니다. |
| 실패함 | 인스턴스가 실패했는지 여부를 나타냅니다. |
| IndexerName | 인덱서의 이름입니다. |
| IndexName | 인덱스의 이름입니다. |
| SkillsetName | 인덱서 실행 중에 사용되는 기술 세트의 이름입니다. |
| SkillName | 기술 세트 내의 기술에 대한 이름입니다. |
| SkillType | 기술의 @odata.type입니다. |
리소스 로그
이 섹션에는 이 서비스에 대해 모을 수 있는 리소스 로그 유형이 나열되어 있습니다. 이 섹션은 Azure Monitor에서 지원되는 모든 리소스 로그 범주 유형 목록에서 가져옵니다.
Microsoft.Search/searchServices에 지원되는 리소스 로그
| 범주 | 범주 표시 이름 | 로그 테이블 | 기본 로그 플랜 지원 | 수집 시간 변환 지원 | 예제 쿼리 | 내보낼 비용 |
|---|---|---|---|---|---|---|
OperationLogs |
작업 로그 | AzureDiagnostics 여러 Azure 리소스의 로그. |
아니요 | 아니요 | 아니요 |
Azure Monitor 로그 테이블
이 섹션에서는 Kusto 쿼리를 사용하여 Log Analytics에서 쿼리할 수 있는 이 서비스와 관련된 Azure Monitor 로그 테이블을 나열합니다. 테이블에는 리소스 로그 데이터가 포함되며 수집 및 라우팅되는 항목에 따라 더 많은 데이터가 포함될 수 있습니다.
Search Service
Microsoft.Search/searchServices
| 테이블 | 설명 |
|---|---|
| AzureActivity | Azure 활동 로그의 항목은 컨트롤 플레인 작업에 대한 인사이트를 제공합니다. 컨트롤 플레인에서 호출되는 작업(예: 복제본(replica) 및 파티션 추가 또는 제거)은 "관리 키 가져오기" 작업을 통해 표시됩니다. |
| AzureDiagnostics | 로그되는 쿼리 및 인덱싱 작업입니다. Log Analytics의 AzureDiagnostics 테이블에 대한 쿼리에는 공통 속성, 검색 관련 속성 및 스키마 참조 섹션에 나열된 검색 관련 작업이 포함될 수 있습니다. |
| AzureMetrics | 상태 및 성능을 측정하는 Azure AI Search에서 내보낸 메트릭 데이터입니다. |
리소스 로그 테이블
다음 표에서는 Azure AI Search의 리소스 로그 속성을 나열합니다. 리소스 로그는 Azure Monitor 로그 또는 Azure Storage에 수집됩니다. Azure Monitor에서 로그는 리소스 공급자 이름 Microsoft.Search아래의 AzureDiagnostics 테이블에서 수집됩니다.
| Azure Storage 필드 또는 속성 | Azure Monitor 로그 속성 | 설명 |
|---|---|---|
| time | timestamp | 작업이 발생한 날짜 및 시간(UTC)입니다. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | 로그를 사용할 수 있는 Azure AI Search 리소스입니다. |
| category | "OperationLogs" | 로그 범주에는 Audit, Operational및 ExecutionRequest. |
| operationName | 속성 | 작업의 이름입니다. 작업 이름은 , ,, , Indexes.StatsIndexers.List, Query.Search, Query.LookupQuery.Suggest, DataSources.ListServiceStatsIndexers.WarmupQuery.AutocompleteIndexes.UpdateCORS.PreflightIndexes.Prototype등일 Indexes.ListIndexStatsSummaries수 있습니다. Indexes.Get |
| durationMS | DurationMilliseconds | 밀리초 단위의 작업 기간입니다. |
| operationVersion | ApiVersion | 요청에 사용되는 API 버전입니다. |
| resultType | (실패) ? "실패": "성공" | 응답의 형식입니다. |
| resultSignature | 상태 | 작업의 HTTP 응답 상태. |
| 속성 | 속성 | 이 이벤트 범주와 관련된 확장 속성입니다. |
활동 로그
연결된 테이블에는 이 서비스의 활동 로그에 기록할 수 있는 작업이 나열되어 있습니다. 이 작업은 활동 로그에서 가능한 모든 리소스 공급자 작업의 하위 집합입니다.
활동 로그 항목의 스키마에 대한 자세한 내용은 활동 로그 스키마를 참조하세요.
다음 표에서는 활동 로그에 기록될 수 있는 Azure AI Search와 관련된 일반적인 작업을 나열합니다. 모든 Microsoft.Search 작업의 전체 목록은 Microsoft.Search 리소스 공급자 작업을 참조 하세요.
| 연산 | 설명 |
|---|---|
| 관리자 키 가져오기 | 관리 권한이 필요한 모든 작업은 "관리 키 가져오기" 작업으로 기록됩니다. |
| 쿼리 키 가져오기 | 인덱스의 문서 컬렉션에 대한 읽기 전용 작업입니다. |
| 관리 키 다시 생성 | 기본 또는 보조 관리자 API 키를 다시 생성하기 위한 요청입니다. |
일반적인 항목에는 API 키에 대한 참조( 관리 키 가져오기 및 쿼리 키 가져오기와 같은 일반 정보 알림)가 포함됩니다. 이러한 활동은 관리 키(개체 만들기 또는 삭제) 또는 쿼리 키를 사용하여 수행한 요청을 나타내지만 요청 자체는 표시하지 않습니다. 이 특성의 정보에 대해 리소스 로깅을 구성해야 합니다.
또는 변경 기록을 통해 약간의 인사이트를 얻을 수 있습니다. Azure Portal에서 활동을 선택하여 세부 정보 페이지를 연 다음 기본 작업에 대한 정보를 보려면 "변경 기록"을 선택합니다.
기타 스키마
이 서비스에는 다음 스키마가 사용되고 있습니다.
쿼리 또는 사용자 지정 보고서를 작성하는 경우 Azure AI Search 리소스 로그가 포함된 데이터 구조는 다음 스키마를 준수합니다.
Blob 스토리지에 보내는 리소스 로그의 경우 각 Blob에는 로그 개체 배열이 포함된 레코드라는 하나의 루트 개체가 있습니다. 각 Blob에는 동일한 시간 동안 발생한 모든 작업에 대한 레코드가 포함됩니다.
리소스 로그 스키마
Azure Monitor를 통해 사용할 수 있는 모든 리소스 로그는 최상위 공통 스키마를 공유합니다. Azure AI Search는 검색 서비스에 고유한 더 많은 속성 과 작업을 보완합니다.
다음 예제에서는 공통 속성(TimeGenerated, Resource, Category 등)과 검색 관련 속성(OperationName 및 OperationVersion)이 포함된 리소스 로그를 보여 줍니다.
| 속성 | Type | 설명 및 예 |
|---|---|---|
| TimeGenerated | DateTime | 작업의 타임스탬프입니다. 예: 2021-12-07T00:00:43.6872559Z |
| 리소스 | 문자열 | 리소스 ID입니다. 예: /subscriptions/<your-subscription-id>/resourceGroups/<your-resource-group-name>/providers/Microsoft.Search/searchServices/<your-search-service-name> |
| 범주 | 문자열 | "OperationLogs"입니다. 이 값은 상수입니다. OperationLogs는 리소스 로그에 사용되는 유일한 범주입니다. |
| OperationName | 문자열 | 작업의 이름입니다(전체 작업 목록 참조). 예는 Query.Search입니다. |
| OperationVersion | 문자열 | 요청에 사용되는 api-version입니다. 예: 2020-06-30 |
| ResultType | 문자열 | "Success"입니다. 기타 가능한 값: Success 또는 Failure |
| ResultSignature | 정수 | HTTP 결과 코드입니다. 예: 200 |
| DurationMS | 정수 | 작업 기간(밀리초)입니다. |
| 속성 | Object | 작업 관련 데이터를 포함하는 개체입니다. 다음 속성 스키마 표를 참조하세요. |
속성 스키마
다음 속성은 Azure AI Search와 관련이 있습니다.
| 속성 | Type | 설명 및 예 |
|---|---|---|
| Description_s | 문자열 | 작업의 엔드포인트입니다. 예: GET /indexes('content')/docs |
| Documents_d | 정수 | 처리된 문서 수입니다. |
| IndexName_s | 문자열 | 작업과 연결된 인덱스의 이름입니다. |
| Query_s | 문자열 | 요청에 사용되는 쿼리 매개 변수입니다. 예: ?search=beach access&$count=true&api-version=2020-06-30 |
OperationName 값(로그된 작업)
리소스 로그에 다음 작업이 나타날 수 있습니다.
| OperationName | 설명 |
|---|---|
| DataSources.* | 인덱서 데이터 원본에 적용됩니다. Create, Delete, Get, List일 수 있습니다. |
| DebugSessions.* | 디버그 세션에 적용됩니다. Create, Delete, Get, List, Start 및 Status일 수 있습니다. |
| DebugSessions.DocumentStructure | 보강된 문서가 디버그 세션에 로드됩니다. |
| DebugSessions.RetrieveIndexerExecutionHistoricalData | 인덱서 실행 세부 정보에 대한 요청입니다. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | 지식 저장소에 프로젝션되는 보강에 대한 실행 기록입니다. |
| Indexers.* | 인덱서에 적용됩니다. Create, Delete, Get, List 및 Status일 수 있습니다. |
| Indexes.* | 검색 인덱스에 적용됩니다. Create, Delete, Get, List일 수 있습니다. |
| 인덱스. 프로토 타입 | 이 인덱스는 데이터 가져오기 마법사에서 만듭니다. |
| Indexing.Index | 이 작업은 문서를 추가, 업데이트 또는 삭제하는 호출입니다. |
| Metadata.GetMetadata | 검색 서비스 시스템 데이터에 대한 요청입니다. |
| Query.Autocomplete | 인덱스에 대한 자동 완성 쿼리입니다. 쿼리 형식 및 구성을 참조하세요. |
| Query.Lookup | 인덱스에 대한 조회 쿼리입니다. 쿼리 형식 및 구성을 참조하세요. |
| Query.Search | 인덱스에 대한 전체 텍스트 검색 요청입니다. 쿼리 형식 및 구성을 참조하세요. |
| Query.Suggest | 인덱스에 대한 자동 완성 쿼리를 입력합니다. 쿼리 형식 및 구성을 참조하세요. |
| ServiceStats | 이 작업은 로드되거나 새로 고칠 때 포털 개요 페이지를 채우기 위해 직접 또는 암시적으로 호출되는 서비스 통계 가져오기에 대한 일상적인 호출입니다. |
| Skillsets.* | 기술 세트에 적용됩니다. Create, Delete, Get, List일 수 있습니다. |
관련 콘텐츠
- Azure AI Search 모니터링에 대한 설명은 Azure AI Search 모니터링을 참조하세요.
- Azure 리소스 모니터링에 대한 자세한 내용은 Azure Monitor를 사용한 Azure 리소스 모니터링을 참조하세요.