자주 묻는 질문¶
대시보드¶
Guance에서 현재 제공하는 Grafana dashboard JSON template을 Guance 대시보드 JSON 템플릿으로 변환하는 node 스크립트가 있나요?
npm 다운로드:
사용 방법:
$ npm install -g @cloudcare/guance-front-tools
# 사용 정보 표시
$ grafanaCovertToGuance
# 작업 실행
$ grafanaCovertToGuance -d examples/grafana.json -o examples/guance.json
Keywords：
none
탐색기¶
탐색기 검색창에서 JSON 형식을 사용할 수 없는 이유는 무엇인가요?
JSON 검색을 사용하려면 다음 세 가지 조건을 충족해야 합니다.
- 사이트가 "중국 지역 1(항저우)", "중국 지역 3(장자커우)", "중국 지역 4(광저우)"인 경우
- 워크스페이스가
2022년 6월 23일이후에 생성된 경우 - 로그 탐색기에서만 사용 가능
예약 보고서¶
예약 보고서 이메일에서 414 오류가 발생하는 이유는 무엇인가요?
최종 수신자 메일함으로 전송되는 예약 보고서에서 이미지 링크는 해당 대시보드의 차트에 뷰 변수 등의 매개변수를 반복하여 결합하여 생성됩니다. 뷰 변수 내용이 너무 길면 생성된 이미지 링크가 길어져 414 오류가 발생할 수 있습니다.
내장 뷰¶
바인딩했는데 상세 페이지에 표시되지 않는 이유는 무엇인가요?
다음을 확인하세요.
- 사용자 뷰를 바인딩했는지 확인합니다(시스템 뷰는 먼저 복제 필요).
- 필드 이름과
value값이 탐색기 데이터와 일치하는지 확인합니다. value일치 패턴이 올바른지 확인합니다(와일드카드*vs 특정 값).
하나의 탐색기에 여러 개의 뷰를 바인딩할 수 있나요?
네, 가능합니다. 여러 필드가 다른 뷰와 일치하는 경우 우선순위 순서대로 표시됩니다. 동일한 필드가 여러 뷰와 일치하는 경우 첫 번째 뷰만 표시됩니다.
차트에 "데이터 없음"이 표시되는 이유는 무엇인가요?
가능한 원인:
- 시간 범위 선택이 잘못되었습니다. 시간 범위를 넓혀보세요.
- 필터 조건이 너무 엄격합니다. 태그와 키워드가 올바른지 확인하세요.
- 데이터가 아직 보고되지 않았습니다. DataKit 수집기가 정상적으로 실행 중인지 확인하세요.
차트의 "고정 시간"은 무엇을 의미하나요?
고정 시간은 해당 차트가 특정 시간대의 데이터를 고정적으로 쿼리하여 대시보드 상단의 시간 선택기 변경에 영향을 받지 않음을 의미합니다. 과거 기준 데이터를 비교하는 데 적합합니다.
복합 차트와 단일 차트의 차이점은 무엇인가요?
복합 차트는 여러 차트를 하나의 카드에 배치하고 Tab 전환으로 확인하여 공간을 절약하고 연관 분석을 용이하게 합니다. 동일한 지표의 다른 차원 비교(예: CPU 사용률의 TOP10 컨테이너 및 TOP10 프로세스)에 적합합니다.
뷰 변수를 어떻게 구성해야 적용되나요?
뷰 변수를 생성한 후 차트 쿼리에서 해당 변수(예: host::tag)를 참조해야 차트 오른쪽 상단에 필터 드롭다운 상자가 나타납니다.
공유한 차트 링크를 다른 사람이 열 수 없으면 어떻게 하나요?
공유 설정을 확인하세요.
- "암호화 공유"가 아닌 "공개 공유"를 선택했는지 확인합니다.
- 링크가 유효 기간 내에 있는지 확인합니다.
- 상대방 네트워크에서 콘솔에 액세스할 수 있는지 확인합니다.
탐색기¶
탐색기 검색창에서 JSON 형식을 사용할 수 없는 이유는 무엇인가요?
JSON 검색을 사용하려면 다음 세 가지 조건을 충족해야 합니다.
- 사이트가 "중국 지역 1(항저우)", "중국 지역 3(장자커우)", "중국 지역 4(광저우)"인 경우
- 워크스페이스가
2022년 6월 23일이후에 생성된 경우 - 로그 탐색기에서만 사용 가능
탐색기와 대시보드의 사용 사례는 각각 무엇인가요?
| 차원 | 대시보드 | 탐색기 |
|---|---|---|
| 데이터 세분화 | 집계 데이터(추세, 통계값) | 상세 데이터(단일 로그, 단일 트레이스) |
| 핵심 용도 | 모니터링 대시보드, 추세 분석, 리포트 및 프레젠테이션 등 | 장애 해결, 보안 감사, 데이터 탐색 등 |
| 상호 작용 방식 | 시각화 차트, 변수 필터 등 | 검색 필터, 하이라이트, 컨텍스트 확장 등 |
탐색기의 필터 조건과 대시보드가 왜 연동되지 않나요?
탐색기의 필터는 현재 탐색기 페이지에만 적용되며, 대시보드의 필터(뷰 변수)는 해당 대시보드 내의 모든 차트에 적용됩니다. 둘은 독립적입니다.
차트에 "데이터 없음"이 표시되는 이유는 무엇인가요?
가능한 원인:
- 시간 범위 선택이 잘못되었습니다. 시간 범위를 넓혀보세요.
- 필터 조건이 너무 엄격합니다. 태그와 키워드가 올바른지 확인하세요.
- 데이터가 아직 보고되지 않았습니다. DataKit 수집기가 정상적으로 실행 중인지 확인하세요.
차트의 "고정 시간"은 무엇을 의미하나요?
고정 시간은 해당 차트가 특정 시간대의 데이터를 고정적으로 쿼리하여 대시보드 상단의 시간 선택기 변경에 영향을 받지 않음을 의미합니다. 과거 기준 데이터를 비교하는 데 적합합니다.
복합 차트와 단일 차트의 차이점은 무엇인가요?
복합 차트는 여러 차트를 하나의 카드에 배치하고 Tab 전환으로 확인하여 공간을 절약하고 연관 분석을 용이하게 합니다. 동일한 지표의 다른 차원 비교(예: CPU 사용률의 TOP10 컨테이너 및 TOP10 프로세스)에 적합합니다.
뷰 변수를 어떻게 구성해야 적용되나요?
뷰 변수를 생성한 후 차트 쿼리에서 해당 변수(예: host::tag)를 참조해야 차트 오른쪽 상단에 필터 드롭다운 상자가 나타납니다.
공유한 차트 링크를 다른 사람이 열 수 없으면 어떻게 하나요?
공유 설정을 확인하세요.
- "암호화 공유"가 아닌 "공개 공유"를 선택했는지 확인합니다.
- 링크가 유효 기간 내에 있는지 확인합니다.
- 상대방 네트워크에서 콘솔에 액세스할 수 있는지 확인합니다.
탐색기¶
탐색기 검색창에서 JSON 형식을 사용할 수 없는 이유는 무엇인가요?
JSON 검색을 사용하려면 다음 세 가지 조건을 충족해야 합니다.
- 사이트가 "중국 지역 1(항저우)", "중국 지역 3(장자커우)", "중국 지역 4(광저우)"인 경우
- 워크스페이스가
2022년 6월 23일이후에 생성된 경우 - 로그 탐색기에서만 사용 가능
탐색기와 대시보드의 사용 사례는 각각 무엇인가요?
| 차원 | 대시보드 | 탐색기 |
|---|---|---|
| 데이터 세분화 | 집계 데이터(추세, 통계값) | 상세 데이터(단일 로그, 단일 트레이스) |
| 핵심 용도 | 모니터링 대시보드, 추세 분석, 리포트 및 프레젠테이션 등 | 장애 해결, 보안 감사, 데이터 탐색 등 |
| 상호 작용 방식 | 시각화 차트, 변수 필터 등 | 검색 필터, 하이라이트, 컨텍스트 확장 등 |
탐색기의 필터 조건과 대시보드가 왜 연동되지 않나요?
탐색기의 필터는 현재 탐색기 페이지에만 적용되며, 대시보드의 필터(뷰 변수)는 해당 대시보드 내의 모든 차트에 적용됩니다. 둘은 독립적입니다.
특정 호스트의 모든 로그를 빠르게 찾으려면 어떻게 하나요?
로그 탐색기 검색창에 host:호스트명을 입력하거나 호스트 목록의 "로그 보기" 바로가기를 클릭합니다.
예약 보고서¶
예약 보고서 이메일에서 414 오류가 발생하는 이유는 무엇인가요?
최종 수신자 메일함으로 전송되는 예약 보고서에서 이미지 링크는 해당 대시보드의 차트에 뷰 변수 등의 매개변수를 반복하여 결합하여 생성됩니다. 뷰 변수 내용이 너무 길면 생성된 이미지 링크가 길어져 414 오류가 발생할 수 있습니다.
보고서를 발송했는데 이메일을 받지 못하면 어떻게 하나요?
다음을 확인하세요.
- 알림 대상의 이메일 주소가 올바른지 확인합니다.
- 이메일이 스팸함으로 차단되었는지 확인합니다.
- 대시보드에 데이터 양이 너무 많아 생성에 실패한 차트가 있는지 확인합니다.
보고서의 차트가 비어서 표시되는 이유는 무엇인가요?
일반적으로 데이터 쿼리 시간 범위가 너무 길거나 차트 계산이 복잡하여 생성 시간이 초과되었기 때문입니다. 시간 범위를 줄이거나 쿼리 조건을 단순화하는 것이 좋습니다.
내장 뷰¶
바인딩했는데 상세 페이지에 표시되지 않는 이유는 무엇인가요?
다음을 확인하세요.
- 사용자 뷰를 바인딩했는지 확인합니다(시스템 뷰는 먼저 복제 필요).
- 필드 이름과
value값이 탐색기 데이터와 일치하는지 확인합니다. value일치 패턴이 올바른지 확인합니다(와일드카드*vs 특정 값).
하나의 탐색기에 여러 개의 뷰를 바인딩할 수 있나요?
네, 가능합니다. 여러 필드가 다른 뷰와 일치하는 경우 우선순위 순서대로 표시됩니다. 동일한 필드가 여러 뷰와 일치하는 경우 첫 번째 뷰만 표시됩니다.
바인딩 후 뷰의 시간 범위를 조정할 수 있나요?
뷰는 기본적으로 "최근 15분"을 표시하지만, 뷰 내에서 시간 범위를 수동으로 조정할 수 있습니다. 조정은 현재 보기에만 영향을 미치며 저장되지 않습니다.
노트¶
노트에 삽입된 차트 데이터는 실시간으로 업데이트되나요?
아니요. 노트에 삽입할 때 차트는 현재 쿼리 결과를 저장하며, 이후 데이터 변경 사항이 자동으로 동기화되지 않습니다. 최신 데이터가 필요하면 차트를 다시 삽입해야 합니다.
내보낸 노트 JSON을 다른 워크스페이스에서 사용할 수 있나요?
네, 가능합니다. "노트 JSON 가져오기" 기능을 통해 노트를 다른 워크스페이스로 마이그레이션할 수 있지만, 연결된 데이터 소스는 다시 구성해야 합니다.
기타¶
P99 피크 값 계산 로직 설명
Guance는 일정 기간 동안 특정 지표의 모든 값을 가져와 작은 값부터 큰 값 순으로 정렬한 후, 데이터 포인트 수 * 99% 를 기준으로 P99에 해당하는 데이터 포인트 위치를 확인하고 해당 위치의 값을 반환합니다. 여기서 "모든 값"은 데이터베이스에 저장된 원시 데이터 포인트를 의미합니다.
지표 데이터의 백분위수 쿼리의 경우, Guance의 처리 방식은 사용되는 데이터 엔진에 따라 다릅니다. 데이터베이스 자체에서 백분위수 쿼리 기능을 지원하지 않는 경우, Guance는 코드를 통해 데이터를 로컬로 가져와 추가 처리하여 이 기능을 구현합니다. 로그, APM, RUM 등 비지표 데이터의 경우 백분위수 쿼리는 데이터베이스의 기본 기능을 통해 지원됩니다.
스냅샷과 스크린샷의 차이점은 무엇인가요?
스냅샷은 대화형 데이터 상태(시간 전환, 드릴다운 분석 지원)를 저장하는 반면, 스크린샷은 정적 이미지일 뿐입니다. 문제 해결 시 공유할 때는 스냅샷을 사용하는 것이 좋습니다.