메모
Foundry IQ (Azure AI 검색)는 관리 검색을 위해 고급 수준의 지식 원본 API 및 지식 베이스 API와 함께 직접 인덱싱 및 쿼리 API를 제공합니다. Azure 포털, REST API 또는 Azure SDK 사용하여 이러한 기능을 구성하거나 Microsoft Foundry 포털의 기술 자료에 에이전트를 연결합니다.
이 문서에는 이 서비스의 모든 모니터링 참고 정보가 포함되어 있습니다.
Foundry IQ에 대해 수집할 수 있는 데이터 및 사용 방법에 대한 자세한 내용은 Azure AI 검색(Monitor Foundry IQ)를 참조하세요.
지표
이 섹션에는 이 서비스의 모든 자동 수집된 플랫폼 지표가 나열되어 있습니다. 이 지표들은 Azure Monitor에서 지원되는
지표 유지에 관한 정보는 Azure Monitor 지표 개요를 참조하세요.
Microsoft.Search/searchServices에 대해 지원되는 메트릭입니다.
다음 표에서는 Microsoft.Search/searchServices 리소스 유형에 대해 사용할 수 있는 메트릭을 나열합니다.
- 모든 테이블에 모든 열이 존재하지 않을 수 있습니다.
- 일부 칼럼은 페이지의 볼 영역을 벗어날 수 있습니다. 모든 사용 가능한 열을 보려면 '테이블 확장 테이블 '을 선택하세요.
테이블 제목
- 카테고리 - 지표의 그룹이나 분류.
- 메트릭 - Azure Portal에 표시되는 메트릭 표시 이름입니다.
- REST API에서의 이름 - REST API에서 참조되는 메트릭 이름입니다.
- 단위 - 측정 단위입니다.
- 집계 - 기본 집계 형식입니다. 유효 값: 평균(Average), 최소(Min), 최대(Max), 총합(Sum), 수.
- 크기 - 해당 메트릭에 사용할 수 있는 크기입니다.
-
시간 그레인 - 미터가 샘플링되는 구간들. 예를 들어,
PT1M는 매분,PT30M는 30분마다,PT1H는 매시간 샘플링된다는 것을 나타냅니다. - DS Export - 진단 설정을 통해 지표를 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 | 예 |
초당 쿼리 검색
이 메트릭은 Foundry IQ 서비스에 대한 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분 동안 총 검색 쿼리 수에서 제한된 검색 쿼리의 백분율과 같은 값을 갖습니다.
컴퓨팅 단위 사용량
컴퓨팅 단위 사용 메트릭(AggregateComputeUnits)은 Foundry IQ 서비스에서 사용하는 컴퓨팅, 메모리 및 I/O 리소스를 측정합니다. 데이터가 밀리 컴퓨팅 단위(mCU)로 표시됩니다. 이 메트릭은 청구서 금액이 아닌 소비에 대한 진단 보기를 제공합니다. 사용량은 실행 중인 작업에 따라 시간이 지남에 따라 달라질 수 있습니다.
적격 유료 서버리스 인덱서 실행의 경우 서비스 집계 사용량을 일정, 실행 기록, 처리된 항목 및 원본 볼륨과 상호 연결합니다. 별도의 문서 및 스킬 수 메트릭의 차원에서 IndexerName 인덱서당 컴퓨팅 단위를 유추하지 마세요. 인덱서 상태 및 서비스 통계의 런타임 초는 컴퓨팅 요금 청구가 아닌 할당량을 측정합니다.
Indexer compute observability를 참조하세요.
다음 두 가지 수준에서 이 메트릭을 볼 수 있습니다.
- Foundry IQ 서비스 전체 수준: 서비스 전체의 집계된 컴퓨팅 소비량입니다.
- 인덱스 수준: 특정 인덱스로 범위가 지정된 사용량으로, 리소스 사용량이 가장 많은 인덱스를 식별하는 데 유용합니다.
| 집계 유형 | 설명 |
|---|---|
| 합계 | 선택한 시간 간격 동안 사용된 총 mKU입니다. 시간에 따른 전반적인 컴퓨팅 비용을 이해하는 데 유용합니다. |
| 평균값 | 선택한 시간 간격 동안 사용된 평균 mKU입니다. |
이 메트릭은 다음 필터를 지원합니다.
인덱스 이름: 메트릭을 특정 인덱스로 필터링합니다. 필터가 적용되지 않으면 메트릭은 서비스의 모든 인덱스에 대한 총 사용량을 반영합니다.
작업 이름: 컴퓨팅 소비에 기여하는 작업 이름을 기준으로 메트릭을 필터링합니다. 필터를 적용하지 않으면 메트릭은 작업 유형 전반에 걸친 결합된 소비량을 반영합니다. 리소스 로그 작업 이름은 지원되는 메트릭 차원 값 목록이 아닙니다.
메트릭 차원
미터 차원이 무엇인지에 대한 자세한 내용은 다차원 미터릭스를 참조하세요.
Foundry IQ에는 실행된 문서 또는 기술의 수를 캡처하는 다음 메트릭과 연결된 차원이 있습니다.
| 메트릭 이름 | 설명 | 차원 | 샘플 사용 사례 |
|---|---|---|---|
| 처리된 문서 수 | 인덱서 처리된 문서 수를 표시합니다. | 데이터 원본 이름, 실패, 인덱스 이름, 인덱서 이름, 스킬셋 이름 | 대략적인 처리량 측정값으로 참조할 수 있습니다(시간이 지남에 따라 인덱서에서 처리되는 문서 수). - 실패한 문서에 대해 경고하도록 설정 |
| 스킬 실행 호출 수 | 기술 호출 수를 표시합니다. | 데이터 원본 이름, 실패, 인덱스 이름, 인덱서 이름, 기술 이름, 기술 유형, 기술 세트 이름 | 참조는 기술 간의 상대 호출 수와 기술 호출 수를 문서 수와 비교하여 기술이 예상대로 호출되는지 확인하는 것입니다. - 실패한 기술 호출에 대해 경고하도록 설정 |
| 컴퓨팅 단위 사용량 | Foundry IQ 서비스에서 작업이 소비한 mCU를 표시합니다. | 인덱스 이름, 작업 | 가장 많은 컴퓨팅을 사용한 작업을 평가합니다. -특정 작업 유형의 굴착토 소비량이 예상 기준치를 초과하면 경고를 설정합니다. |
| 차원 이름 | 설명 |
|---|---|
| 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 | 상태 및 성능을 측정하는 Foundry IQ에서 내보낸 메트릭 데이터입니다. |
리소스 로그 테이블
다음 표에서는 Foundry IQ의 리소스 로그 속성을 나열합니다. 리소스 로그는 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) | 로그가 사용 설정된 Foundry IQ 리소스입니다. |
| 범주 | "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 응답 상태입니다. |
| 속성 | 속성 | 이 이벤트 범주와 관련된 모든 확장 속성입니다. |
활동 로그
링크 테이블은 이 서비스의 활동 로그에 기록할 수 있는 작업을 나열합니다. 이 작업들은 활동 로그에 있는 모든 가능한 자원 제공자 작업의 하위 집합입니다.
활동 로그 항목의 스키마에 대한 자세한 내용은 활동 로그 스키마를 참조하세요.
다음 표에는 활동 로그에 기록될 수 있는 Foundry IQ 관련 일반 작업이 나열되어 있습니다. 모든 Microsoft.Search 작업의 전체 목록은 Microsoft.Search 리소스 공급자 작업을 참조하세요.
| 작업 | 설명 |
|---|---|
| 관리자 키 가져오기 | 관리 권한이 필요한 모든 작업은 "관리자 키 가져오기" 작업으로 기록됩니다. |
| 쿼리 키 가져오기 | 인덱스에 있는 문서 집합에 대한 모든 읽기 전용 작업입니다. |
| 관리 키 다시 생성 | 기본 또는 보조 관리자 API 키를 다시 생성하기 위한 요청입니다. |
일반적인 항목에는 API 키에 대한 참조( 관리자 키 가져오기 및 쿼리 키 가져오기와 같은 일반 정보 알림)가 포함됩니다. 이러한 활동은 관리 키(개체 만들기 또는 삭제) 또는 쿼리 키를 사용하여 수행한 요청을 나타내지만 요청 자체는 표시하지 않습니다. 이 곡물에 대한 자세한 내용은 리소스 로깅을 구성해야 합니다.
또는 변경 기록을 통해 몇 가지 인사이트를 얻을 수 있습니다. Azure 포털에서 활동을 선택하여 세부 정보 페이지를 연 다음 기본 작업에 대한 정보를 보려면 "기록 변경"을 선택합니다.
기타 스키마
이 서비스에는 다음 스키마가 사용되고 있습니다.
쿼리 또는 사용자 지정 보고서를 작성하려는 경우 Foundry IQ 리소스 로그를 포함하는 데이터 구조는 다음 스키마를 따릅니다.
Blob Storage로 전송되는 리소스 로그의 경우 각 Blob에는 로그 개체 배열을 포함하는 레코드 라는 루트 개체가 하나 있습니다. 각 Blob에는 동일한 시간 동안 발생한 모든 작업에 대한 레코드가 포함됩니다.
리소스 로그 스키마
Azure Monitor 통해 사용할 수 있는 모든 리소스 로그는 커먼 최상위 스키마 공유합니다. Foundry IQ에는 Foundry IQ 서비스에 고유한 더 많은 속성과 작업이 있습니다.
다음 예제에서는 공용 속성(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-10-01 |
| ResultType | 문자열 | "성공". 기타 가능한 값: 성공 또는 실패 |
| ResultSignature | Int | HTTP 결과 코드입니다. 예를 들어: 200 |
| DurationMS | Int | 작업 기간(밀리초)입니다. |
| 속성 | 개체 | 작업별 데이터를 포함하는 개체입니다. 다음 속성 스키마 테이블을 참조하세요. |
속성 스키마
다음 속성은 Foundry IQ에만 해당합니다.
| 이름 | 타입 | 설명 및 예제 |
|---|---|---|
| Description_s | 문자열 | 작업의 엔드포인트입니다. 예를 들어: GET /indexes('content')/docs |
| Documents_d | Int | 처리된 문서 수입니다. |
| IndexName_s | 문자열 | 작업과 연결된 인덱스의 이름입니다. |
| Query_s | 문자열 | 요청에 사용되는 쿼리 매개 변수입니다. 예를 들어: ?search=beach access&$count=true&api-version=2026-10-01 |
OperationName 값(기록된 작업)
리소스 로그에 다음 작업이 나타날 수 있습니다.
| OperationName | 설명 |
|---|---|
| DataSources.* | 인덱서 데이터 원본에 적용됩니다. 만들기, 삭제, 가져오기, 목록일 수 있습니다. |
| DebugSessions.* | 디버그 세션에 적용됩니다. 만들기, 삭제, 가져오기, 나열, 시작 및 상태일 수 있습니다. |
| 디버그세션.문서구조 | 보강된 문서가 디버그 세션에 로드됩니다. |
| 디버그세션.색인기실행역사데이터가져오기 | 인덱서 실행 세부 정보에 대한 요청입니다. |
| DebugSessions.RetrieveProjectedIndexerExecutionHistoricalData | 지식 저장소에 투영된 강화 작업의 실행 기록입니다. |
| 인덱서.* | 인덱서에 적용됩니다. 만들기, 삭제, 가져오기, 나열 및 상태일 수 있습니다. |
| 인덱스.* | 검색 인덱스에 적용됩니다. 만들기, 삭제, 가져오기, 목록일 수 있습니다. |
| 인덱스.프로토타입 | 인덱스 메타데이터는 데이터 입력을 기반으로 데이터 가져오기 마법사에 의해 정의됩니다. |
| Indexing.Index | 이 작업은 문서 인덱싱을 호출하는 작업입니다. |
| Metadata.GetMetadata | Foundry IQ 서비스 시스템 데이터에 대한 요청입니다. |
| Query.Autocomplete | 인덱스를 상대로 하는 자동 완성 쿼리입니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| 쿼리.조회 (Query.Lookup) | 인덱스를 상대로 한 조회 쿼리입니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| 쿼리.검색 | 인덱스를 위한 전체 텍스트 검색 요청입니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| Query.Suggest | 인덱스를 상대로 미리 쿼리를 입력합니다. 쿼리 형식 및 컴퍼지션을 참조하세요. |
| ServiceStats | 이 작업은 로드되거나 새로 고칠 때 포털 개요 페이지를 채우기 위해 직접 또는 암시적으로 호출되는 서비스 통계 가져오기에 대한 일상적인 호출입니다. |
| 기술 세트.* | 기술 세트에 적용됨 만들기, 삭제, 가져오기, 목록일 수 있습니다. |
관련 콘텐츠
- Foundry IQ 모니터링에 대한 설명은 Monitor Foundry IQ를 참조하세요.
- Azure자원 모니터링에 대한 자세한 내용은 Azure 모니터링 리소스를 Azure Monitor로 참고하세요.