저장된 쿼리, 기록, 즐겨찾기 및 공동 작업
저장된 쿼리는 조사를 재사용 가능한 팀 아티팩트로 전환합니다. Telemetry는 팀 작업공간 내에서 쿼리를 구성하고 쿼리 기록을 보존하며 각 사용자가 가장 자주 반환하는 쿼리를 즐겨찾기에 추가할 수 있도록 합니다.
SQL을 저장해도 메트릭이 정확하지 않습니다. 다른 사람이나 자동화된 워크플로가 이에 의존하기 전에 이벤트 그레인, 필터, 분모, 단위 및 시간 경계를 검토하세요.
작업공간을 선택하세요
작업 영역을 사용하여 서비스, 제품 영역, 운영 워크플로 또는 팀별로 관련 분석을 그룹화합니다. 작업 영역을 중첩할 수 있으므로 모든 쿼리를 하나의 단순 목록에 넣지 않고도 광범위한 영역에 더 집중된 컬렉션을 포함할 수 있습니다.
스캔할 수 있을 만큼 구조를 얕게 유지하십시오. 실용적인 배열은 다음과 같습니다.
reliability
api
background-jobs
product
activation
retention
ai
model-cost
agent-quality
팀 멤버십은 작업 영역과 저장된 쿼리를 볼 수 있는 사람을 제어합니다. "개인"과 같은 작업공간 이름은 조직 또는 소유권을 설명합니다. 해당 작업공간을 비공개로 만들지는 않습니다. 모든 팀 구성원은 팀의 작업 영역 분석에 접근할 수 있으므로 쿼리에 더 좁은 범위의 대상을 위한 식별자 또는 운영 세부 정보가 포함된 경우 별도의 팀을 사용하십시오.
쿼리 저장 및 이름 지정
초안에서 시작하여 대표적인 시간 범위에 대해 쿼리를 실행하고 결과를 검사합니다. 보관할 준비가 되면:
- 결정을 소유한 작업공간에 저장하세요.
- 유용한 결과, 범위 및 단위로 이름을 바꿉니다.
- 비율과 백분위수 외에 거래량을 유지하세요.
- 저장된 버전을 검토한 후에만 결과를 대시보드에 추가하세요.
query 14 또는 incident query보다 API error rate by route — production를 선호하세요. 이름은 모든 결과를 열지 않고도 쿼리를 찾고 해석하는 데 도움이 되어야 합니다.
쿼리 기록 이해
변경 사항을 저장하면 쿼리 기록이 생성됩니다. 기록 항목을 사용하여 SQL이 어떻게 발전했는지 검토하고 편집으로 인해 결과가 예기치 않게 변경될 때 이전 논리를 복구할 수 있습니다.
공유 쿼리를 실질적으로 변경하기 전에:
- 이전 및 새 메트릭 정의를 확인하세요.
- 동일한 고정 창에서 두 버전을 비교합니다.
- 쿼리를 사용하는 대시보드, 알림 또는 보고서를 식별합니다.
- 소비자가 변경 사항을 검토할 때까지 이전 버전을 보존합니다.
- 의미가 변경되면 설명 대시보드 텍스트를 업데이트합니다.
쿼리가 규제된 보고, 액세스 결정 또는 정확한 재무 조정에 힘을 실어줄 때 기록은 광범위한 감사 추적이나 코드 검토 프로세스를 대체할 수 없습니다.
즐겨찾기를 개인 바로가기로 사용
즐겨찾기는 개인별 탐색 보조 도구입니다. 쿼리를 즐겨찾기에 추가해도 해당 작업 영역, 권한, SQL 또는 다른 팀 구성원의 상태는 변경되지 않습니다. 공유 쿼리를 복제하지 않고 활성 사건 보기, 주간 검토 또는 반복되는 제품 질문에 대한 즐겨찾기를 사용합니다.
안정적인 결과 촉진
저장된 쿼리는 다음과 같습니다.
- 대시보드 차트 또는 결과 테이블
- 명시적인 임계값과 소유자가 있는 알림
- 반복 가능한 내보내기;
- 더 깊은 조사를 위한 출발점.
저장된 쿼리를 검사 가능한 분석 정의로 유지합니다. 응답 지침과 소유권을 대시보드나 알림 옆에 배치하여 핸드오프 중에 아티팩트를 계속 이해할 수 있도록 하세요.
협업 체크리스트
저장된 쿼리를 광범위하게 공유하기 전에 다음을 확인하세요.
- 모든 팀 구성원은 작업 영역 및 쿼리의 대상이 됩니다.
- 제목은 결과와 단위를 설명합니다.
- SQL는 문서화된 필드와 계산 규칙을 사용합니다.
- 대표적인 고정 장치 또는 알려진 간격이 확인되었습니다.
- 민감한 원시 식별자는 광범위한 대시보드에서 생략됩니다.
- 중요한 변경 사항은 이전 기록 항목과 비교됩니다.
- 모든 알림에는 소유자, 평가 기간 및 대응 조치가 있습니다.
대시보드 만들기, 알림 또는 팀, 작업 영역 및 구성원을 계속 진행하세요.