이 자습서에서는 Azure SRE 에이전트 포털의 테스트 플레이그라운드를 사용하여 도구를 배포하기 전에 테스트 및 디버그합니다. 플레이그라운드를 사용하면 사용자 지정 매개 변수를 사용하여 도구를 격리된 상태로 실행하고 결과를 즉시 검토할 수 있습니다.
이 튜토리얼에서는 다음을 배우게 됩니다:
- 모든 도구에 대한 테스트 플레이그라운드에 액세스
- 라이브 쿼리를 사용하여 Kusto 도구 테스트
- 사용자 지정 매개 변수를 사용하여 시스템 도구 테스트
- 배포하기 전에 결과 확인
예상 시간: 5분
사전 요구 사항
시작하기 전에 다음 항목이 있는지 확인합니다.
- 하나 이상의 도구가 만들어졌습니다(Kusto 도구 또는 시스템 도구). 자세한 내용은 Kusto 도구 만들기를 참조하세요.
- SRE 에이전트 포털에 액세스합니다.
놀이터 열기
에이전트 캔버스의 테스트 플레이그라운드로 이동합니다.
- SRE 에이전트 포털을 열고 에이전트를 선택합니다.
- 빌더>에이전트 캔버스를 선택합니다.
- 보기 토글에서 테스트 플레이 그라운드를 선택합니다( 캔버스 보기 및 테이블 보기 옆).
플레이그라운드는 맨 위에 사용자 지정 에이전트/도구 선택기가 있는 빈 상태와 "플레이그라운드 세션을 시작할 에이전트 또는 도구 선택"이라는 메시지가 표시됩니다.
도구 선택
엔터티 선택기에서 테스트할 도구를 선택합니다.
- 맨 위에 있는 사용자 지정 에이전트/도구 드롭다운을 선택합니다.
- 목록을 찾아보거나 검색합니다. 각 항목에는 사용자 지정 에이전트에 대한 자치 , 시스템 도구용 기본 제공 도구 또는 Kusto 도구용 Kusto 도구 와 같은 형식을 나타내는 하위 레이블이 표시됩니다.
- 테스트할 도구를 선택합니다.
- 적용을 선택합니다.
플레이그라운드는 선택한 도구의 구성 및 테스트 인터페이스를 로드합니다.
Kusto 도구 테스트
Kusto 도구를 선택한 경우 다음 단계를 사용하여 테스트합니다.
- 쿼리 구성(클러스터, 데이터베이스, 쿼리 텍스트 및 매개 변수 정의)을 보여주는 왼쪽 패널을 검토합니다.
- 오른쪽 패널에서 쿼리에 필요한 매개 변수 값을 입력합니다.
- 테스트 실행을 선택합니다.
테스트 패널에는 다음 정보가 표시됩니다.
- 성공 또는 실패 상태
- 반환된 행 수 및 열
- 테이블에 표시되는 쿼리 결과
- 실행 시간(밀리초)
녹색 성공 표시기가 연결된 클러스터에 대해 쿼리가 올바르게 실행되는지 확인합니다.
메모
테스트를 성공적으로 실행할 때까지 저장 단추를 사용할 수 없습니다. 이 조건을 사용하면 클러스터에 대해 실제로 작동하는 쿼리만 저장할 수 있습니다.
팁 (조언)
쿼리가 예기치 않은 결과를 반환하는 경우 KQL을 조정하고 테스트 실행을 다시 선택합니다. 놀이터를 떠나지 않고 반복할 수 있습니다.
시스템 도구 테스트
시스템 도구를 선택하는 경우 다음 단계를 사용하여 테스트합니다.
- 도구 정보(이름, 설명, 플러그 인 및 범주)를 표시하는 왼쪽 패널을 검토합니다.
- 오른쪽 패널에서 필요한 매개 변수 값을 입력합니다.
- 도구 실행을 선택합니다.
이 도구는 포함된 편집기에서 JSON 출력을 실행하고 표시합니다. 출력이 입력의 예상 동작과 일치하는지 확인합니다.
확인 및 반복
테스트 후 결과를 검토하고 필요에 따라 구체화합니다.
- Kusto 도구: 결과가 올바르지 않으면 KQL을 조정하고 다시 실행합니다. 쿼리가 올바르면 저장 을 선택합니다. 저장은 테스트 실행이 성공한 후에만 사용하도록 설정됩니다.
- 시스템 도구: 출력이 예기치 않은 경우 매개 변수 값을 확인하고 다시 실행합니다.
저장을 선택하면 Kusto 도구에 대한 변경 내용이 저장됩니다. 시스템 도구는 사용자가 제공하는 매개 변수를 사용하여 실행되므로 저장이 필요하지 않습니다.
Troubleshooting
다음 정보를 사용하여 일반적인 문제를 해결합니다.
선택기에서 도구가 표시되지 않음
하나 이상의 도구를 만들어야 합니다. 에이전트 캔버스 도구 모음에서 만들기>도구>를 선택하여 생성합니다.
Kusto 도구에 "구성된 커넥터 없음"이 표시됩니다.
Kusto 도구 테스트에는 데이터 커넥터가 필요합니다. Builder>Connectors로 이동하여 클러스터 URL 및 데이터베이스를 사용하여 Azure Data Explorer 커넥터를 추가합니다. 그런 다음 놀이터로 돌아가서 Kusto 도구를 다시 선택합니다.
Kusto 테스트에 권한 부여 오류가 표시됩니다.
에이전트가 Kusto 클러스터에 액세스해야 합니다. 다음 항목을 확인합니다.
- Builder> Connectors에서 클러스터에 대한 데이터커넥터를 구성했습니다.
- 커넥터 자격 증명에는 대상 데이터베이스에 대한 쿼리 권한이 있습니다.
시스템 도구에서 오류를 반환합니다.
다음 항목을 확인합니다.
- 모든 필수 매개 변수를 입력했습니다.
- 매개 변수 값은 예상 형식(문자열, 숫자 및 유사한 값)과 일치합니다.
- 도구 이름과 플러그 인이 올바르게 구성되었습니다.
Python 도구가 나열되지 않음
Python 도구에는 Python 도구 편집기 내에 고유한 테스트 인터페이스가 있습니다. 에이전트 캔버스에서 편집기를 엽니다. Python 도구를 테스트하려면 편집기에서 기본 제공 테스트 패널을 사용합니다.