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 | 예 |
초당 검색 쿼리
이 메트릭은 검색 서비스에 대한 QPS(초당 검색 쿼리 수)의 평균을 보여 줍니다. 일반적으로 쿼리는 밀리초 단위로 실행되므로 초 단위로 측정되는 쿼리만 QPS와 같은 메트릭에 표시됩니다. 최솟값은 해당 분 동안 등록된 초당 쿼리 수의 가장 낮은 값입니다. 최대값은 가장 높은 값입니다. 평균은 전체 분에 대한 집계입니다.
| 집계 유형 | 설명 |
|---|---|
| 평균 | 1분간 쿼리가 실행된 평균 시간(초). |
| Count | 1분간 로그로 내보내진 메트릭 수. |
| 최대 | 1분간 등록된 초당 최고 검색 쿼리 수. |
| 최소 | 1분간 등록된 초당 최저 검색 쿼리 수. |
| Sum | 1분간 실행된 모든 쿼리의 합계. |
예를 들어, 1분 내에 다음과 같은 패턴을 발견할 수 있습니다. SearchQueriesPerSecond에 대한 최대 로드 1초, 이후 평균 로드 58초, 그리고 마지막으로 최소값인 한 개의 쿼리만 있는 1초가 이어집니다.
또 다른 예제로, 각 메트릭의 값이 40이고 노드가 100 메트릭을 내보내는 경우 “개수”는 100, “합계”는 4000, “평균”은 40, “최대”는 40입니다.
Search latency
쿼리 대기 시간은 쿼리가 완료되는 데 걸리는 시간을 나타냅니다.
| 집계 유형 | 대기 시간 |
|---|---|
| 평균 | 평균 쿼리 지속시간(밀리초). |
| Count | 1분간 로그로 내보내진 메트릭 수. |
| 최대 | 샘플에서 가장 오래 실행되는 쿼리. |
| 최소 | 샘플에서 가장 짧게 실행되는 쿼리. |
| 총계 | 간격(1분) 내에 실행되는 샘플 내 모든 쿼리의 총 실행 시간. |
제한된 검색 쿼리 백분율
이 메트릭은 처리되지 않고 삭제된 쿼리를 나타냅니다. 제한은 실행 중인 요청 수가 용량을 초과할 때 발생합니다. 복제본이 순환에서 벗어났거나 인덱싱 중인 경우 제한된 요청이 증가하는 것을 볼 수 있습니다. 쿼리 및 인덱싱 요청은 모두 동일한 리소스 집합에서 처리됩니다.
서비스는 리소스 소비량에 따라 요청을 드롭할지 여부를 결정합니다. 메모리, CPU 및 디스크 IO에 걸쳐 사용되는 리소스의 비율은 일정 시간에 걸쳐 평균값이 계산됩니다. 해당 백분율이 임계값을 초과하는 경우 요청 볼륨이 감소할 때까지 인덱스에 대한 모든 요청이 제한됩니다.
클라이언트에 따라 다음과 같은 방법으로 제한된 요청이 표시됩니다.
- 서비스에서 오류를 반환합니다.
"You are sending too many requests. Please try again later." - 서비스에서 서비스를 현재 사용할 수 없음을 나타내는 503 오류 코드를 반환합니다.
- 포털(예: 검색 탐색기)을 사용하는 경우 쿼리가 자동으로 삭제되고 검색을 다시 선택해야 합니다.
제한된 쿼리를 확인하려면 제한된 검색 쿼리 메트릭을 사용합니다. 포털에서 메트릭을 탐색하거나 이 문서에 설명된 대로 경고 메트릭을 만들 수 있습니다. 샘플링 간격 내에 삭제된 쿼리의 경우 Total을 사용하여 실행되지 않은 쿼리의 비율을 가져옵니다.
| 집계 유형 | 제한 |
|---|---|
| 평균 | 간격 내에 드롭된 쿼리의 비율. |
| Count | 1분간 로그로 내보내진 메트릭 수. |
| 최대 | 간격 내에 드롭된 쿼리의 비율. |
| 최소 | 간격 내에 드롭된 쿼리의 비율. |
| 총계 | 간격 내에 드롭된 쿼리의 비율. |
제한된 검색 쿼리 백분율의 경우 최소, 최대, 평균 및 합계가 모두 다음과 같은 값을 가집니다. 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 활동 로그의 항목은 컨트롤 플레인 작업에 대한 인사이트를 제공합니다. 복제본 및 파티션 추가 또는 제거와 같이 컨트롤 플레인에서 호출되는 작업은 "관리자 키 가져오기" 작업을 통해 표시됩니다. |
| 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입니다. 예: 2024-07-01 |
| 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=2024-07-01 |
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 리소스 모니터링을 참조하세요.