데이터 검색¶

Obsy Copilot 는 사용자가 쿼리 문을 작성하도록 도와주거나, 자연어를 뷰어 필터 조건으로 변환할 수 있습니다. 이 두 가지 기능은 목표가 다릅니다. DQL / PromQL 어시스턴트는 읽고 재사용할 수 있는 쿼리 문을 제공하며, 뷰어 자연어 검색은 현재 페이지의 데이터를 필터링하는 데 사용됩니다.

DQL / PromQL 도우미¶

DQL / PromQL 도우미는 쿼리 문을 생성, 설명, 수정 및 검토하고, 변환할 수 있는 DQL을 플랫폼 PromQL로 다시 작성하는 데 사용됩니다. DQL을 생성할 때 Obsy Copilot 는 현재 워크스페이스의 실제 데이터 소스, 필드 및 태그를 우선적으로 확인하고 최종 DQL에 대해 구문 검사를 수행합니다.

이 기능은 사용자가 "최근 로그 보기"를 요청한다고 해서 기본적으로 DQL을 반환하지는 않습니다. DQL / PromQL을 작성, 설명, 수정, 검토 또는 변환하라는 명시적인 요청이 있을 때만 쿼리 언어 프로세스가 시작됩니다.

다음과 같은 쿼리 작업에 적합합니다.

• DQL 또는 PromQL 구문에 익숙하지 않아 목표에 따라 쿼리를 생성해야 하는 경우
• 기존 쿼리가 통과되지 않거나, 결과 기준이 명확하지 않거나, 위험을 확인해야 하는 경우
• 기존 쿼리의 필터, 집계, 그룹화 및 시간 범위를 이해하려는 경우
• 메트릭 DQL을 플랫폼 PromQL로 변환해야 하는 경우
• 일반적인 예제가 아닌 현재 워크스페이스의 실제 필드를 기반으로 한 쿼리를 얻고자 하는 경우

쿼리 작성 또는 확인¶

Obsy Copilot 에서 직접 쿼리 목표를 설명하고 가능한 다음 정보를 제공하세요.

• 데이터 도메인: 메트릭, 로그, 이벤트, 트레이스, RUM 또는 기타 데이터 유형
• 데이터 객체: 알려진 measurement, source, service 또는 필드
• 시간 범위: 예: 최근 30분 또는 지난 7일
• 통계 기준: 총계, 비율, 평균, 백분위수, TopN 또는 그룹화 차원
• 출력 유형: DQL, 플랫폼 PromQL 또는 표준 Prometheus 쿼리

예시:

현재 워크스페이스에 대한 DQL을 생성해 주세요. 최근 30분 동안 서비스별 오류 로그 수를 집계하고, 수량 내림차순으로 상위 10개 서비스를 반환합니다.

쿼리를 수정하거나 설명해야 하는 경우 원래 문을 그대로 붙여넣고 예상 결과를 설명하세요. 데이터 도메인, 시간 범위 또는 통계 기준에 모호함이 있는 경우 Obsy Copilot 는 데이터 소스와 필드를 추측하지 않고 추가 정보를 요청합니다.

쿼리 결과 및 검증¶

DQL을 생성할 때 Obsy Copilot 는 기본적으로 요구 사항에 가장 적합하고 구문 검사가 완료된 쿼리 하나를 반환하며, 데이터 소스, 필터 조건, 집계 및 시간 범위를 간략히 설명합니다. 현재 워크스페이스에서 필드 또는 데이터 소스를 확인할 수 없는 경우 제한 사항을 설명하고 사용자에게 선택을 요청하며, 확인되지 않은 필드를 실제로 존재하는 것처럼 설명하지 않습니다.

PromQL을 생성할 때는 기본적으로 플랫폼에서 지원하는 measurement:field 메트릭 규칙을 사용합니다. 이 프로세스에서는 PromQL이 실제로 실행되지 않습니다. 대상 쿼리 페이지에서 실행하여 데이터 결과를 확인하세요. DQL의 구문 검사 역시 문 구조만 확인할 뿐, 선택한 시간 범위 내에 데이터가 반드시 존재한다는 것을 의미하지는 않습니다.

뷰어 자연어 검색¶

뷰어 자연어 검색은 사용자의 설명을 현재 뷰어에서 인식할 수 있는 쿼리 조건으로 변환하고, 기존 쿼리 및 시간 범위와 함께 페이지에서 실행합니다. 이 기능은 뷰어 구문에 익숙하지 않지만 필터링할 대상, 상태 또는 값 범위를 이미 알고 있는 사용자에게 적합합니다.

현재 이 기능은 자연어 검색이 지원되는 로그, 트레이스, RUM, 기본 객체, 리소스 카탈로그, 이벤트, 신서틱 모니터링, 보안, 클라우드 청구, 백업 로그, Agent 모니터링 및 LLM 등의 뷰어에서 사용할 수 있습니다.

필터 조건 설정¶

이 기능을 지원하는 뷰어에서 자연어로 필터링 대상을 설명하세요. 예:

service가 checkout이고 상태가 비정상이며 지연 시간이 2초를 초과하는 데이터를 찾고, 최근 3시간만 확인합니다.

같음, 같지 않음, 포함, 와일드카드, 정규식, 숫자 비교, 범위, 필드 존재 여부, AND, OR, NOT 등의 조합 조건을 표현할 수 있습니다. 실제 사용 가능한 작업은 현재 필드 유형에 따라 다릅니다.

기본적으로 Obsy Copilot 는 쿼리 상자에 이미 있는 조건을 유지하고 그 뒤에 새 조건을 추가합니다. 기존 조건을 대체하려면 "재쿼리", "원래 조건 지우기", "다음만 검색" 또는 "다음으로 바꾸기"와 같은 표현을 명확히 사용하세요.

조건 변환 규칙¶

Obsy Copilot 는 현재 뷰어에서 제공하는 필드 목록을 기반으로 쿼리 조건을 생성합니다.

• 현재 필드 또는 필드 별칭과 명확하게 대응할 수 있는 내용은 구조화된 필터 조건으로 변환됩니다.
• 필드를 확인할 수 없는 키워드는 일반 텍스트 검색으로 유지되며, 유사한 필드에 강제로 매핑되지 않습니다.
• 서비스 이름, 리소스 이름, ID, URL, 경로 및 오류 텍스트와 같은 비즈니스 값은 가능한 원래 텍스트를 유지합니다.
• 사용자가 명확히 지정한 시간 표현은 뷰어 시간 위젯으로 전달됩니다.

생성된 결과는 현재 뷰어 필터링에 사용되며, DQL을 생성하지 않고 데이터를 수정하지도 않습니다. 필드가 현재 페이지의 사용 가능한 필드에 나타나지 않는 경우, 다른 뷰어에 동일한 이름의 필드가 있더라도 이를 구조화된 조건으로 사용하지 않습니다.