텔레메트리 소스를 연결해 에이전트의 답변을 일반 지식이 아닌 본인의 신호에 근거하세요. 텔레메트리 커넥터를 설정한 후에는 평범한 언어로 조사 질문을 하세요. 에이전트는 쿼리를 실행하고 실수로 답변합니다.
이 튜토리얼은 텔레메트리 카테고리의 커넥터를 다룹니다. Azure Data Explorer는 Azure MCP Kusto 경로를 사용합니다. 서드파티 텔레메트리 커넥터도 텔 레메트리 탭에 나타나며, 이들은 백그라운드에서 MCP를 사용하더라도 마찬가지입니다. 설정은 모든 관리 커넥터와 동일한 마법사를 사용하기 때문에, 이 글에서는 텔레메트리 세부 사항에 초점을 맞춥니다: 소스가 어떻게 인증되는지, 어떤 연산을 활성화해야 하는지, 그리고 쿼리로 검증하는 방법입니다.
중요합니다
관리 커넥터는 미리보기 단계입니다. 커넥터의 가용성, 필드, 운영은 변할 수 있습니다.
사전 요구 사항
- 실행 중인 SRE 에이전트와 sre.azure.com 접근 권한.
- 에이전트에서 커넥터 설정 권한.
- 연결 중인 텔레메트리 소스에 대한 접근 권한을 읽어보세요. Azure 소스의 경우, 연결을 승인하는 신원은 최소한 대상 리소스에 대한 읽기 권한이 필요합니다.
커넥터를 설정해본 적이 없다면, 전체 마법사 워크스루를 위한 관리 커넥터 설정 부터 시작하세요. 이 글은 텔레메트리 소스 차이만을 언급합니다.
텔레메트리 커넥터
| 커넥터 | 서비스 | Authentication | 일반적인 용도 |
|---|---|---|---|
| Azure Data Explorer (via Azure MCP) | Azure Data Explorer(Kusto) | 관리형 아이덴티티 | ADX 클러스터에 대해 KQL 쿼리를 실행하세요 |
| Log Analytics 작업 영역 | Log Analytics | 관리형 아이덴티티 | 읽기 전용 모드에서 작업 공간 로그를 조회 |
| Application Insights | Application Insights | 관리형 아이덴티티 | 읽기 전용 모드에서의 애플리케이션 텔레메트리 쿼리 |
| Datadog | Datadog | 커넥터가 보여주는 서비스 자격 증명 | 쿼리 메트릭, 로그 및 모니터 |
| Elasticsearch | Elasticsearch | 커넥터가 보여주는 서비스 자격 증명 | 검색 로그 및 인덱스 텔레메트리 |
| Dynatrace | Dynatrace | 커넥터가 보여주는 서비스 자격 증명 | 관측성 데이터 및 추적 쿼리 |
| New Relic (뉴 렐릭) | New Relic (뉴 렐릭) | 커넥터가 보여주는 서비스 자격 증명 | 조회 텔레메트리 및 인시전 |
| Splunk | Splunk | 커넥터가 보여주는 서비스 자격 증명 | 검색 스플렁크 로그 및 이벤트 |
| 호크아이 (뉴버드) | 뉴버드의 호크아이 | 커넥터가 보여주는 서비스 자격 증명 | AI 기반 관측성 데이터를 조회 |
서드파티 텔레메트리 커넥터는 기본 URL, 인증, 헤더 힌트를 포함하여 연결 설정을 돕습니다.
사용자가 제공한 커넥터를 통해 또 다른 원격 측정 소스를 추가할 수도 있습니다. 팀에 커스텀 도구나 커넥터 선택기에 없는 소스가 있을 때 이 옵션을 사용하세요.
1단계: 커넥터 추가
sre.azure.com 이동하여 에이전트를 선택합니다.
왼쪽 사이드바에서 빌더를 펼친 후 커넥터를 선택하세요.
커넥터 추가를 선택합니다.
텔레메트리 탭을 선택한 후 텔레메트리 소스를 선택하세요. Azure Data Explorer의 경우, Azure MCP Kusto 경로를 사용하는 Azure Data Explorer를 선택하세요.
2단계: 인증
For Azure telemetry connectors:
커넥터가 표시하는 필드를 완성하세요.
- Azure Data Explorer의 경우, 커넥터 이름을 지정하고, 에이전트가 Kusto를 쿼리할 때 사용하는 관리 식별자를 선택한 후, 클러스터 URL이 포함된 하나 이상의 클러스터 그룹을 추가하세요.
- Log Analytics Workspace의 경우, 워크스페이스 픽커에서 워크스페이스를 선택하거나 워크페이스의 ARM 리소스 ID를 수동으로 입력하세요.
- Application Insights를 위해 리소스 선택기에서 Application Insights 리소스를 선택하거나 리소스 ARM 리소스 ID를 수동으로 입력하세요.
커넥터가 관리 신원 을 요청하면 선택하세요.
마법사에서 제시한 검토, 클러스터 또는 도구 선택 단계로 계속 진행하세요.
관리 신원은 대상 자원에 대한 읽기 권한을 가져야 합니다. 만약 쿼리가 권한 오류로 실패하면, 해당 신원에 대한 읽기 권한을 부여하고 다시 쿼리를 시도하세요.
3단계: 쿼리 도구 설정
도구 설정 단계에서 텔레메트리를 읽는 연산을 활성화하세요. 쿼리 연산은 텔레메트리 커넥터의 핵심이므로 런-쿼리 또는 검색 연산을 선택하세요. 필요하지 않으면 행정 운영은 비활성화하세요.
모든 읽기 작업을 Allow 로 설정해 에이전트가 일시정지 없이 질문에 답할 수 있게 하세요. 데이터를 변경하는 어떤 연산이든 활성화하면 Ask로 설정하세요.
Azure Data Explorer를 Azure MCP로 사용하는 경우, 이 마법사는 클러스터 그룹 단계와 연결 테스트 검토 단계를 포함합니다. 클러스터 그룹을 설정하고, 연결성을 테스트한 후 커넥터를 저장하세요. Kusto 도구 세트는 Azure MCP Kusto 경로에서 처리됩니다.
팁
활성화된 세트를 작게 유지하세요. 텔레메트리 커넥터는 보통 쿼리 연산만 필요합니다. 도구가 적으면 에이전트가 더 신뢰할 수 있는 도구를 선택하고 80개 도구 예산 내에서 사용할 수 있습니다.
4단계: 질문으로 검증하기
에이전트와 채팅을 시작하세요.
텔레메트리가 필요한 질문을 하세요. 다음은 그 예입니다.
How many errors were logged in the last hour, grouped by service?반응을 잘 보세요. 도구 카드는 에이전트가 커넥터의 쿼리 도구를 선택하고 쿼리를 실행한 후, 텔레메트리에 기반한 답변을 보여줍니다.
일반적인 설명 대신 자신의 출처에서 실제 카운트를 보면, 커넥터는 끝에서 끝까지 작동합니다.
Troubleshooting
| 문제 | Cause | 수정 |
|---|---|---|
| 쿼리는 "무단 상태" 또는 "금지된" 결과를 반환합니다 | 연결 식별은 읽기 권한이 없습니다 | 대상 리소스에 대한 식별 읽기 권한을 부여한 후 다시 시도합니다. |
| 쿼리가 "찾을 수 없음"을 반환합니다 | 잘못된 작업 공간, 클러스터, 데이터베이스, 또는 테이블 이름 | 서비스 명칭을 정확히 확인하세요. 이름은 대/소문자를 구분합니다. |
| 서드파티 커넥터가 연결할 수 없습니다 | URL, 토큰, 헤더 값이 잘못되었습니다 | 관측 관리자와 값을 확인하고 커넥터를 업데이트하세요. |
| 답변은 일반적이며 툴 카드도 나타나지 않습니다 | 질문은 당신의 텔레메트리가 필요하지 않았습니다 | 질문에 텔레메트리가 필요하도록 다시 표현하세요. 예를 들어 "서비스 X에서 마지막 날까지 실패한 요청을 세라"는 식으로요. |
| 커넥터는 저장되었지만 텔레메트리는 반환되지 않았습니다 | 비어 있거나 필터링된 결과 | 질문에서 시간 범위를 넓히거나, 소스가 최근 텔레메트리를 가지고 있는지 확인해 보세요. |