메모
Azure AI 검색 Azure 포털, REST API 및 Azure SDK 통해 사용할 수 있습니다. 또한 엔터프라이즈 콘텐츠를 Microsoft Foundry 포털의 에이전트에 대해 재사용 가능한 사용 권한 인식 기술 자료로 변환하는 관리되는 기술 계층인 Foundry IQ를 뒷받침합니다.
이 문서에는 이 서비스의 모든 모니터링 참고 정보가 포함되어 있습니다.
Azure AI 검색 위해 수집할 수 있는 데이터 및 사용 방법에 대한 자세한 내용은 모니터 Azure AI 검색를 참조하세요.
지표
이 섹션에는 이 서비스의 모든 자동 수집된 플랫폼 지표가 나열되어 있습니다. 이 지표들은 Azure Monitor에서 지원되는
지표 유지에 관한 정보는 Azure Monitor 지표 개요를 참조하세요.
Microsoft.Search/searchServices에 대해 지원되는 메트릭입니다.
다음 표에서는 Microsoft.Search/searchServices 리소스 유형에 대해 사용할 수 있는 메트릭을 나열합니다.
- 모든 테이블에 모든 열이 존재하지 않을 수 있습니다.
- 일부 칼럼은 페이지의 볼 영역을 벗어날 수 있습니다. 모든 사용 가능한 열을 보려면 '테이블 확장 테이블 '을 선택하세요.
표 제목
- 카테고리 - 지표 그룹 또는 분류.
- Metric - Azure 포털에 표시되는 미터법 표시 이름입니다.
- REST API에서의 이름 - REST API에서 참조되는 메트릭 이름입니다.
- 단위 - 측정 단위.
- 집계 - 기본 집계 유형입니다. 유효 값: 평균(Average), 최소(Min), 최대(Max), 총합(Sum), 수.
- 치수 - 이 측정 항목에 대한 사용 가능한 치수.
-
타임 그레인 - 지표가 샘플링되는 간격입니다. 예를 들어,
PT1M는 매분,PT30M는 30분마다,PT1H는 매시간 샘플링된다는 것을 나타냅니다. - DS 내보내기- 진단 설정을 통해 Azure Monitor 로그로 내보낼 수 있는지 여부. 지표 내보내기에 관한 정보는 Azure Monitor에서 진단 설정 생성 항목을 참조하세요.
| 메트릭 | REST API에서의 이름 | 고급 플랫폼 메트릭 | 단위 | 집계 | 차원 | 시간 입자 | DS 내보내기 |
|---|---|---|---|---|---|---|---|
|
인덱서 처리된 파일(바이트) 파일 기반 데이터 원본에서 인덱서가 처리한 총 원본 데이터 바이트(예: Blob, ADLS Gen2, File, SharePoint, OneLake) |
DocumentsProcessedBytes |
아니요 | Bytes | 전체(합계), 평균 |
DataSourceName, IndexerName, IndexName |
PT1M | 예 |
|
문서 처리된 개수 처리된 문서 수 |
DocumentsProcessedCount |
아니요 | 횟수 | 합계, 개수 |
DataSourceName, Failed, , IndexerName, IndexNameSkillsetName |
PT1M | 예 |
|
스토리지 사용량 인덱스별 검색 서비스에 대한 스토리지 사용량(텍스트 + 벡터) |
IndexStorageUsage |
아니요 | Bytes | 평균, 최대, 최소 | IndexName |
PT1M | 예 |
|
벡터 스토리지 사용량 인덱스별 검색 서비스에 대한 벡터 스토리지 사용량 |
IndexVectorUsage |
아니요 | Bytes | 평균, 최대, 최소 | IndexName |
PT1M | 예 |
|
사용된 컴퓨팅 단위 검색 서비스 작업 및 인덱스 웜 윈도우에서 사용된 컴퓨팅 단위를 마이크로 CU-시간 단위로 계산합니다(CU-시간을 구하려면 총계를 1,000,000으로 나누세요). 상태 필터는 더 이상 사용되지 않습니다. |
PerRequestComputeConsumption |
아니요 | 횟수 | 전체(합계), 평균 |
Status, IndexName, , ResourceKind, EventType |
PT1M | 예 |
|
검색 대기 시간 검색 서비스에 대한 평균 검색 대기 시간 |
SearchLatency |
아니요 | 초 | 평균 | <전혀 없습니다> | PT1M | 예 |
|
초당 쿼리 검색 검색 서비스에 대한 초당 검색 쿼리 |
SearchQueriesPerSecond |
아니요 | CountPerSecond | 평균 | <전혀 없습니다> | PT1M | 예 |
|
기술 실행 호출 수 기술 실행 수 |
SkillExecutionCount |
아니요 | 횟수 | 합계, 개수 |
DataSourceName, Failed, IndexerName, SkillName, SkillsetNameSkillType |
PT1M | 예 |
|
제한된 검색 쿼리 백분율 검색 서비스에 대해 제한된 검색 쿼리의 백분율 |
ThrottledSearchQueriesPercentage |
아니요 | 백분율(%) | 평균 | <전혀 없습니다> | PT1M | 예 |
초당 쿼리 검색
이 메트릭은 검색 서비스에 대한 QPS(초당 검색 쿼리 수)의 평균을 보여 줍니다. 일반적으로 쿼리는 밀리초 단위로 실행되므로 초 단위로 측정되는 쿼리만 QPS와 같은 메트릭에 표시됩니다. 최소값은 해당 분 동안 등록된 초당 검색 쿼리의 최하위 값입니다. 최대값은 가장 높은 값입니다. 평균은 1분 간의 집계된 값입니다.
| 집계 유형 | 설명 |
|---|---|
| 평균 | 쿼리 실행이 발생한 1분 이내의 평균 시간(초)입니다. |
| 횟수 | 1분 간격 내에 로그에 내보낸 메트릭 수입니다. |
| 최대 | 1분 동안 등록된 초당 검색 쿼리 수가 가장 높습니다. |
| 최소 | 1분 동안 등록된 초당 가장 낮은 검색 쿼리 수입니다. |
| 합계 | 1분 내에 실행된 모든 쿼리의 합계입니다. |
예를 들어 1분 이내에 다음과 같은 패턴이 있을 수 있습니다. 즉, SearchQueriesPerSecond의 최대값인 높은 부하의 1초, 평균 로드 58초, 마지막으로 최소 쿼리가 하나만 있는 1초입니다.
또 다른 예: 노드에서 각 메트릭의 값이 40인 100개의 메트릭을 내보내는 경우 "Count"는 100, "Sum"은 4000, "Average"는 40, "Max"는 40입니다.
검색 대기 시간
검색 대기 시간은 쿼리를 완료하는 데 걸리는 시간을 나타냅니다.
| 집계 유형 | 지연 시간 |
|---|---|
| 평균 | 평균 쿼리 기간(밀리초)입니다. |
| 횟수 | 1분 간격 내에 로그에 내보낸 메트릭 수입니다. |
| 최대 | 샘플에서 가장 오래 실행되는 쿼리입니다. |
| 최소 | 샘플에서 가장 짧은 실행 쿼리입니다. |
| 총 | 샘플에 있는 모든 쿼리의 총 실행 시간(1분) 이내에 실행됩니다. |
제한된 검색 쿼리 백분율
이 메트릭은 처리되지 않고 삭제된 쿼리를 나타냅니다. 제한은 실행 중인 요청 수가 용량을 초과할 때 발생합니다. 복제본이 로테이션에서 제외되거나 인덱싱 중에 스로틀링된 요청이 증가할 수 있습니다. 쿼리 및 인덱싱 요청은 모두 동일한 리소스 집합에 의해 처리됩니다.
서비스는 리소스 소비에 따라 요청을 삭제할지 여부를 결정합니다. 메모리, CPU 및 디스크 IO에서 사용되는 리소스의 비율은 일정 기간 동안 평균됩니다. 이 비율이 임계값을 초과하면 요청 볼륨이 줄어들 때까지 인덱스에 대한 모든 요청이 제한됩니다.
클라이언트에 따라 다음과 같은 방법으로 제한된 요청이 표시됩니다.
- 서비스에서 오류를 반환합니다.
"You are sending too many requests. Please try again later." - 서비스는 현재 서비스를 사용할 수 없음을 나타내는 503 오류 코드를 반환합니다.
- Azure 포털(예: 검색 탐색기)을 사용하는 경우 쿼리가 자동으로 삭제되고 Search 다시 선택해야 합니다.
제한된 쿼리를 확인하려면 제한된 검색 쿼리 메트릭을 사용합니다. 이 문서에 설명된 대로 Azure 포털에서 메트릭을 탐색하거나 경고 메트릭을 만들 수 있습니다. 샘플링 간격 내에 삭제된 쿼리의 경우 Total 을 사용하여 실행되지 않은 쿼리의 비율을 가져옵니다.
| 집계 유형 | 제한 |
|---|---|
| 평균 | 간격 내에 삭제된 쿼리의 백분율입니다. |
| 횟수 | 1분 간격 내에 로그에 내보낸 메트릭 수입니다. |
| 최대 | 간격 내에 삭제된 쿼리의 백분율입니다. |
| 최소 | 간격 내에 삭제된 쿼리의 백분율입니다. |
| 총 | 간격 내에 삭제된 쿼리의 백분율입니다. |
제한된 검색 쿼리 백분율, 최소값, 최대값, 평균 및 합계의 경우 모두 1분 동안 총 검색 쿼리 수에서 제한된 검색 쿼리의 백분율과 같은 값을 갖습니다.
컴퓨팅 단위 사용량
이 메트릭은 mKU(밀리 컴퓨팅 단위)로 표현된 Azure AI 검색 서비스에서 사용하는 컴퓨팅, 메모리 및 I/O 리소스를 측정합니다. 다양한 작업 유형의 처리 비용에 대한 프록시 역할을 합니다. 사용량은 실행 중인 작업에 따라 시간이 지남에 따라 달라질 수 있습니다.
다음 두 가지 수준에서 이 메트릭을 볼 수 있습니다.
- 검색 서비스 수준: 전체 서비스에서 집계된 컴퓨팅 사용량입니다.
- 인덱스 수준: 특정 인덱스로 범위가 지정된 사용량으로, 리소스 사용량이 가장 많은 인덱스를 식별하는 데 유용합니다.
| 집계 유형 | 설명 |
|---|---|
| 합계 | 선택한 시간 간격 동안 사용된 총 mKU입니다. 시간에 따른 전반적인 컴퓨팅 비용을 이해하는 데 유용합니다. |
| 평균 | 선택한 시간 간격 동안 사용된 평균 mKU입니다. |
이 메트릭은 다음 필터를 지원합니다.
인덱스 이름: 메트릭을 특정 인덱스로 필터링합니다. 필터가 적용되지 않으면 메트릭은 서비스의 모든 인덱스에 대한 총 사용량을 반영합니다.
작업 이름: 컴퓨팅 소비에 기여하는 작업을 기준으로 메트릭을 필터링합니다. 필터가 적용되지 않으면 메트릭은 모든 작업 유형에서 결합된 소비량을 반영합니다. 지원되는 값은 모니터링 데이터 참조를 참조하세요.
메트릭 차원
미터 차원이 무엇인지에 대한 자세한 내용은 다차원 미터릭스를 참조하세요.
Azure AI 검색에는 실행된 문서 수 또는 기술 수를 집계하는 다음 메트릭과 관련된 차원이 있습니다.
| 메트릭 이름 | 설명 | 차원 | 샘플 사용 사례 |
|---|---|---|---|
| 문서 처리된 개수 | 인덱서 처리된 문서 수를 표시합니다. | 데이터 원본 이름, 실패, 인덱스 이름, 인덱서 이름, 스킬셋 이름 | 대략적인 처리량 측정값으로 참조할 수 있습니다(시간이 지남에 따라 인덱서에서 처리되는 문서 수). - 실패한 문서에 대해 경고하도록 설정 |
| 기술 실행 호출 수 | 기술 호출 수를 표시합니다. | 데이터 원본 이름, 실패, 인덱스 이름, 인덱서 이름, 기술 이름, 기술 유형, 기술 세트 이름 | 참조는 기술 간의 상대 호출 수와 기술 호출 수를 문서 수와 비교하여 기술이 예상대로 호출되는지 확인하는 것입니다. - 실패한 기술 호출에 대해 경고하도록 설정 |
| 컴퓨팅 단위 사용량 | 검색 서비스의 작업에서 사용하는 mKU를 표시합니다. | 인덱스 이름, 작업 | 가장 많은 컴퓨팅을 사용한 작업을 평가합니다. -특정 작업 유형의 굴착토 소비량이 예상 기준치를 초과하면 경고를 설정합니다. |
| 차원 이름 | 설명 |
|---|---|
| DataSourceName | 인덱서 실행 중에 사용되는 명명된 데이터 원본 연결입니다. 유효한 값은 지원되는 데이터 원본 형식 중 하나입니다. |
| 실패 | 인스턴스가 실패했는지 여부를 나타냅니다. |
| IndexerName | 인덱서의 이름입니다. |
| IndexName | 인덱스의 이름입니다. |
| SkillsetName | 인덱서 실행 중에 사용되는 기술 세트의 이름입니다. |
| SkillName | 기술 세트 내의 기술 이름입니다. |
| SkillType | 기술의 @odata.type입니다. |
리소스 로그
이 섹션에서는 이 서비스를 위해 수집할 수 있는 자원 로그 유형을 나열합니다. 이 섹션은 Azure Monitor에서 지원하는
Microsoft.Search/searchServices에 대한 지원되는 리소스 로그
| 범주 | 수출 비용 | 로그 테이블 | 기본 로그 플랜 지원 | 섭취-시간 변환 지원 | 예제 쿼리 |
|---|---|---|---|---|---|
| OperationLogs | 아니요 |
AzureDiagnostics 여러 Azure 리소스에서 나오는 로그입니다. |
아니요 | 아니요 |
Azure Monitor 로그 테이블
이 섹션은 이 서비스와 관련된 Azure Monitor 로그 테이블을 나열하며, Log Analytics가 Kusto 쿼리를 통해 쿼리할 수 있습니다. 테이블에는 자원 로그 데이터가 포함되어 있으며, 수집되고 라우팅되는 내용에 따라 그 이상도 포함될 수 있습니다.
검색 서비스
Microsoft.Search/searchServices
| 테이블 | 설명 |
|---|---|
| AzureActivity | Azure 활동 로그의 항목은 컨트롤 플레인 작업에 대한 인사이트를 제공합니다. 복제본 및 파티션 추가 또는 제거와 같이 컨트롤 플레인에서 호출되는 작업은 "관리자 키 가져오기" 작업을 통해 표시됩니다. |
| AzureDiagnostics | 기록된 쿼리 및 인덱싱 작업입니다. Log Analytics AzureDiagnostics 테이블에 대한 쿼리에는 공통 속성, search 관련 속성 및 스키마 참조 섹션에 나열된 search 관련 작업 포함할 수 있습니다. |
| AzureMetrics | 상태 및 성능을 측정하는 Azure AI 검색 내보낸 메트릭 데이터입니다. |
리소스 로그 테이블
다음 표에서는 Azure AI 검색 리소스 로그의 속성을 나열합니다. 리소스 로그는 Azure Monitor 로그 또는 Azure Storage 수집됩니다. Azure Monitor 로그는 Microsoft.Search 리소스 공급자 이름으로 AzureDiagnostics 테이블에 수집됩니다.
| Azure Storage 필드 또는 속성 | Azure Monitor Logs 속성 | 설명 |
|---|---|---|
| 시간 | 타임 스탬프 | 작업이 발생한 날짜 및 시간(UTC)입니다. |
| resourceId | Concat("/", "/subscriptions", SubscriptionId, "resourceGroups", ResourceGroupName, "providers/Microsoft.Search/searchServices", ServiceName) | 로그가 활성화된 Azure AI 검색 리소스입니다. |
| 범주 | "OperationLogs" | 로그 범주에는 Audit, Operational및 ExecutionRequest. |
| 작업명 | 이름 | 작업의 이름입니다. 작업 이름은 Indexes.ListIndexStatsSummaries, Indexes.Get, Indexes.Stats, Indexers.List, Query.Search, Query.Suggest, Query.Lookup, Query.Autocomplete, CORS.Preflight, Indexes.Update, Indexes.Prototype, ServiceStats, DataSources.List, Indexers.Warmup일 수 있습니다. |
| durationMS | 지속 시간 밀리초 | 작업 기간(밀리초)입니다. |
| 운영 버전 | ApiVersion | 요청에 사용되는 API 버전입니다. |
| 결과 유형 | (실패) ? "실패": "성공" | 응답의 형식입니다. |
| resultSignature | 상태 | 작업의 HTTP 응답 상태입니다. |
| 속성 | 속성 | 이 이벤트 범주와 관련된 모든 확장 속성입니다. |
활동 로그
링크 테이블은 이 서비스의 활동 로그에 기록할 수 있는 작업을 나열합니다. 이 작업들은 활동 로그에 있는 모든 가능한 자원 제공자 작업의 하위 집합입니다.
활동 로그 항목의 스키마에 대한 자세한 내용은 활동 로그 스키마를 참조하세요.
다음 표에서는 활동 로그에 기록될 수 있는 Azure AI 검색 관련된 일반적인 작업을 나열합니다. 모든 Microsoft.Search 작업의 전체 목록은 Microsoft.Search 리소스 공급자 작업을 참조하세요.
| 작업 | 설명 |
|---|---|
| 관리자 키 가져오기 | 관리 권한이 필요한 모든 작업은 "관리자 키 가져오기" 작업으로 기록됩니다. |
| 쿼리 키 가져오기 | 인덱스에 있는 문서 집합에 대한 모든 읽기 전용 작업입니다. |
| 관리 키 다시 생성 | 기본 또는 보조 관리자 API 키를 다시 생성하기 위한 요청입니다. |
일반적인 항목에는 API 키에 대한 참조( 관리자 키 가져오기 및 쿼리 키 가져오기와 같은 일반 정보 알림)가 포함됩니다. 이러한 활동은 관리 키(개체 만들기 또는 삭제) 또는 쿼리 키를 사용하여 수행한 요청을 나타내지만 요청 자체는 표시하지 않습니다. 이 곡물에 대한 자세한 내용은 리소스 로깅을 구성해야 합니다.
또는 변경 기록을 통해 몇 가지 인사이트를 얻을 수 있습니다. Azure 포털에서 활동을 선택하여 세부 정보 페이지를 연 다음 기본 작업에 대한 정보를 보려면 "기록 변경"을 선택합니다.
기타 스키마
이 서비스에는 다음 스키마가 사용되고 있습니다.
쿼리 또는 사용자 지정 보고서를 작성하는 경우 Azure AI 검색 리소스 로그가 포함된 데이터 구조는 다음 스키마를 준수합니다.
Blob Storage로 전송되는 리소스 로그의 경우 각 Blob에는 로그 개체 배열을 포함하는 레코드 라는 루트 개체가 하나 있습니다. 각 Blob에는 동일한 시간 동안 발생한 모든 작업에 대한 레코드가 포함됩니다.
리소스 로그 스키마
Azure Monitor 통해 사용할 수 있는 모든 리소스 로그는 커먼 최상위 스키마 공유합니다. Azure AI 검색는 검색 서비스에 고유한 속성과작업을 보충합니다.
다음 예제에서는 공용 속성(TimeGenerated, Resource, Category 등) 및 검색 관련 속성(OperationName 및 OperationVersion)을 포함하는 리소스 로그를 보여 줍니다.
| 이름 | 타입 | 설명 및 예제 |
|---|---|---|
| TimeGenerated | 날짜 및 시간 | 작업의 타임스탬프입니다. 예를 들어: 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 |
| 작동버전 | 문자열 | 요청에 사용되는 api-version입니다. 예를 들어: 2026-04-01 |
| ResultType | 문자열 | "성공". 기타 가능한 값: 성공 또는 실패 |
| ResultSignature | Int | HTTP 결과 코드입니다. 예를 들어: 200 |
| DurationMS | Int | 작업 기간(밀리초)입니다. |
| 속성 | 개체 | 작업별 데이터를 포함하는 개체입니다. 다음 속성 스키마 테이블을 참조하세요. |
속성 스키마
다음 속성은 Azure AI 검색 관련됩니다.
| 이름 | 타입 | 설명 및 예제 |
|---|---|---|
| Description_s | 문자열 | 작업의 엔드포인트입니다. 예를 들어: GET /indexes('content')/docs |
| Documents_d | Int | 처리된 문서 수입니다. |
| IndexName_s | 문자열 | 작업과 연결된 인덱스의 이름입니다. |
| Query_s | 문자열 | 요청에 사용되는 쿼리 매개 변수입니다. 예를 들어: ?search=beach access&$count=true&api-version=2026-04-01 |
OperationName 값(기록된 작업)
리소스 로그에 다음 작업이 나타날 수 있습니다.
| OperationName | 설명 |
|---|---|
| DataSources.* | 인덱서 데이터 원본에 적용됩니다. 만들기, 삭제, 가져오기, 목록일 수 있습니다. |
| DebugSessions.* | 디버그 세션에 적용됩니다. 만들기, 삭제, 가져오기, 나열, 시작 및 상태일 수 있습니다. |
| 디버그세션.문서구조 | 보강된 문서가 디버그 세션에 로드됩니다. |
| 디버그세션.색인기실행역사데이터가져오기 | 인덱서 실행 세부 정보에 대한 요청입니다. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | 지식 저장소에 투영된 강화 작업의 실행 기록입니다. |
| 인덱서.* | 인덱서에 적용됩니다. 만들기, 삭제, 가져오기, 나열 및 상태일 수 있습니다. |
| 인덱스.* | 검색 인덱스에 적용됩니다. 만들기, 삭제, 가져오기, 목록일 수 있습니다. |
| 인덱스.프로토타입 | 인덱스 메타데이터는 데이터 입력을 기반으로 데이터 가져오기 마법사에 의해 정의됩니다. |
| Indexing.Index | 이 작업은 문서 인덱싱을 호출하는 작업입니다. |
| Metadata.GetMetadata | 검색 서비스 시스템 데이터에 대한 요청입니다. |
| Query.Autocomplete | 인덱스를 상대로 하는 자동 완성 쿼리입니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| 쿼리.조회 (Query.Lookup) | 인덱스를 상대로 한 조회 쿼리입니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| 쿼리.검색 | 인덱스를 위한 전체 텍스트 검색 요청입니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| Query.Suggest | 인덱스를 상대로 미리 쿼리를 입력합니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| ServiceStats | 이 작업은 로드되거나 새로 고칠 때 포털 개요 페이지를 채우기 위해 직접 또는 암시적으로 호출되는 서비스 통계 가져오기에 대한 일상적인 호출입니다. |
| 기술 세트.* | 기술 세트에 적용됨 만들기, 삭제, 가져오기, 목록일 수 있습니다. |
관련 콘텐츠
- 모니터링 Azure AI 검색 대한 설명은 모니터 Azure AI 검색를 참조하세요.
- Azure자원 모니터링에 대한 자세한 내용은 Azure 모니터링 리소스를 Azure Monitor로 참고하세요.