모바일¶

Guance App은 모바일 기기에서 워크스페이스의 인시던트, 관측 데이터, 온콜 스케줄 및 계정 설정을 확인하고 처리할 수 있도록 지원합니다. App은 현재 '홈, 관측, 인시던트, 스케줄, 프로필'의 다섯 가지 진입점으로 기능을 구성하고 있습니다. 알림 또는 협업 알림을 수신한 후 신속하게 인시던트 상세로 이동하여 로그, 트레이스, 이벤트, RUM 및 대시보드 데이터를 확인하고, 상태 전환, 협업 댓글, 링크 공유 및 Handoff를 통해 문제를 계속 처리할 수 있습니다.

설치¶

Guance 워크스페이스 내에서 '통합' - '모바일'을 통해 다운로드하거나 아래 QR 코드를 스캔하여 다운로드할 수 있습니다.

또는 아래 링크를 클릭하여 직접 다운로드할 수도 있습니다.

기존 Guance 무료/상용 플랜 사용자는 App에서 계정이 속한 사이트를 선택하고 비밀번호, SMS 인증 코드 또는 SSO를 통해 로그인할 수 있습니다. 사이트 목록은 현재 제품 라인에 따라 표시되며, 로그인 페이지에서 사이트 정보를 새로고침할 수도 있습니다.

비밀번호 로그인: 이메일 또는 계정, 비밀번호를 입력하여 로그인하며, 계정 기억을 선택할 수 있습니다.
인증 코드 로그인: 휴대폰 번호와 6자리 인증 코드를 입력하여 로그인하며, 인증 코드를 보내기 전에 이미지 인증이 필요할 수 있습니다.
SSO 로그인: 이메일 또는 전체 SSO 주소를 입력하고, 페이지 안내에 따라 로그인 진입점, 워크스페이스를 선택하여 싱글 사인온을 완료합니다.
비밀번호 분실: 비밀번호 로그인 페이지에서 비밀번호 재설정 절차를 진행하고, 계정 인증 후 새 비밀번호를 설정합니다.
MFA: 워크스페이스에서 MFA 보안 정책이 활성화된 경우, 로그인 또는 워크스페이스 전환 시 페이지 안내에 따라 인증을 완료해야 합니다. 처음 바인딩할 때도 바인딩 절차가 표시됩니다.

아직 Guance 계정이 없다면 Guance 공식 웹사이트에서 지금 신청하여 적합한 사이트 계정을 등록할 수 있습니다.

로그인에 성공하면 App은 현재 계정이 액세스할 수 있는 기본 워크스페이스로 진입합니다. 홈, 관측, 인시던트, 스케줄 또는 '프로필'에서 워크스페이스를 전환할 수 있으며, 전환 후 해당 페이지의 데이터는 새 워크스페이스 기준으로 다시 로드됩니다.

팀에서 프라이빗 배포 사이트를 사용하는 경우, 로그인 페이지의 사이트 선택기에서 프라이빗 사이트를 추가하고 해당 사이트에서 로그인을 완료할 수 있습니다.

프라이빗 사이트 추가

로그인 페이지에서 '사이트'를 클릭하여 사이트 선택기를 엽니다.
'프라이빗 사이트 추가'를 클릭합니다.
'대상 주소'에 프라이빗 사이트의 Console 주소 또는 사이트 디렉터리 주소를 입력합니다. 예: https://console.company.com 또는 https://urls.company.com/
'식별 및 미리보기'를 클릭하면 App이 자동으로 사이트 이름, Console 주소, API 주소 및 지원되는 로그인 방식을 식별합니다.
사이트 이름을 확인한 후 '추가 및 저장'을 클릭합니다. 여러 사이트가 식별된 경우, 페이지 안내에 따라 로그인 페이지에서 기본으로 사용할 사이트를 선택하세요.

저장에 성공하면 프라이빗 사이트가 사이트 선택기의 '프라이빗' 그룹에 나타납니다. 대상 사이트를 선택한 후 비밀번호, 인증 코드 또는 SSO 로그인을 계속 사용할 수 있습니다. 구체적인 로그인 방식은 해당 프라이빗 사이트의 구성에 따라 다릅니다.

프라이빗 사이트 관리

프라이빗 사이트를 추가한 후, 로그인 페이지의 사이트 선택기에서 '프라이빗 사이트 관리'를 클릭하여 원격 디렉터리를 새로고침하고, 기본 사이트를 전환하고, 더 이상 사용하지 않는 구성을 삭제하거나 진단 정보를 복사하여 문제 해결에 사용할 수 있습니다. 원격 디렉터리 새로고침이 실패하면 App은 마지막으로 성공적으로 동기화된 로컬 캐시를 우선 사용합니다.

사이트 디렉터리 주소 형식

사이트 디렉터리 주소를 사용하는 경우, 디렉터리 주소는 App이 액세스할 수 있는 HTTPS URL이어야 합니다. 예: https://urls.company.com/ 또는 https://urls.company.com/site-map.json 프로토콜이 없거나 http:// 주소를 입력한 경우, App은 자동으로 https://로 변환하여 접속합니다. 해당 주소가 반환하는 내용은 JSON 객체여야 하며, 최상위 레벨에 urls 필드를 포함해야 합니다. urls 아래의 각 key는 하나의 사이트를 나타내며, 사이트 내에는 Console과 API 주소를 제공해야 합니다.

예시는 다음과 같습니다.

{
  "urls": {
    "prod": {
      "name": "회사 프로덕션 환경",
      "name_en": "Company Production",
      "console": "https://console.company.com",
      "console_api": "https://console-api.company.com"
    },
    "staging": {
      "name": "회사 스테이징 환경",
      "name_en": "Company Staging",
      "console": "https://staging-console.company.com",
      "console_api": "https://staging-console-api.company.com"
    }
  }
}

여기서 name 및 name_en은 사이트 이름을 표시하는 데 사용됩니다. console은 웹 콘솔 주소이고, console_api는 비즈니스 API 주소입니다.

참고: 프라이빗 사이트 주소는 현재 네트워크 환경에서 HTTPS를 통해 액세스할 수 있어야 합니다. 식별에 실패한 경우, 주소가 유효한 Console 주소 또는 사이트 디렉터리 주소인지 확인하고, 네트워크, VPN, 인증서 및 사이트 구성을 점검하세요.

홈¶

홈은 현재 주의가 필요한 인시던트를 집계합니다. 여기에는 현재 워크스페이스의 미할당 인시던트와 사용자에게 할당되었지만 아직 해결되지 않은 인시던트가 포함됩니다. 홈에서 다음 작업을 신속하게 수행할 수 있습니다.

인시던트 이름, 등급, 상태, 처리자, 업데이트 시간 및 온콜 정보 확인
최근 시간 또는 정확한 시간 범위를 선택하여 특정 기간의 인시던트 검색
아래로 스와이프하여 현재 워크스페이스의 인시던트 목록 새로고침
인시던트를 길게 눌러 다중 선택 모드로 진입, 일괄 인계, 해결됨으로 표시 또는 인시던트 상태 변경
인시던트 카드를 클릭하여 상세 페이지로 이동, 계속 조사 및 협업
워크스페이스 전환 및 홈 데이터 다시 로드

현재 워크스페이스에 처리할 인시던트가 없으면 홈에 빈 상태 메시지가 표시됩니다.

관측¶

'관측'은 모바일에서 대시보드, 로그, 트레이스, 이벤트 및 RUM을 조회할 수 있는 진입점을 제공합니다. 모바일 기기에서 주요 데이터를 빠르게 확인하거나, 공유 링크 또는 Handoff를 통해 해당 데이터 상세로 이동할 수 있습니다.

대시보드¶

'관측' - '대시보드 보기'에서 현재 워크스페이스에서 액세스 가능한 대시보드 목록을 확인할 수 있습니다. 대시보드는 이름 검색, 빠른 필터, 태그 필터, 즐겨찾기 및 생성/업데이트 정보 확인을 지원합니다. 대시보드 상세로 이동하면 다음을 수행할 수 있습니다.

대시보드 내의 차트, 테이블, 상위 목록, 숫자, 텍스트 등 구성 요소 확인
시간 위젯을 사용하여 최근 시간 또는 정확한 시간 범위 전환
대시보드 변수 조정, 서비스, 호스트, 애플리케이션 등 차원 기준 데이터 전환
구성 요소 이름 검색, 대상 차트 빠르게 찾기
차트 개요와 차트 읽기 모드 간 전환, 그룹별 차트 펼치기 또는 접기
단일 구성 요소 확대, 공유 또는 Handoff를 통해 해당 콘솔 링크 열기

대시보드는 웹 버전과 내용이 동기화됩니다. 자세한 내용은 대시보드를 참조하세요.

로그, 트레이스, 이벤트 및 RUM 조회¶

'관측'에서 각각 로그, 트레이스, 이벤트 및 RUM 조회 페이지로 이동할 수 있습니다.

로그: 로그 인덱스 선택, 키워드 또는 key:value 조건으로 로그 레코드 조회, 로그 상세로 이동하여 필드 내용 확인
트레이스: trace_id, 서비스, 상태 등 조건으로 Trace 조회, 워터폴 차트로 Span 호출 관계 확인
이벤트: 주요 이벤트 세부 정보 확인, 이벤트 ID, 모니터 필드 등 조건으로 이벤트 찾기
RUM: View, Action, Resource, Long Task, Error 등 유형별 사용자 액세스 데이터 조회, 상세에서 Trace 또는 Resource 연결

조회 페이지는 최근 시간, 정확한 시간, 필드 제안 및 값 제안을 지원합니다. 레코드 상세를 열면 요약, 필드 목록, 원본 내용을 확인하고 콘솔 링크를 공유할 수 있습니다. Trace 워터폴 차트에서는 연결된 RUM Resource를 확인하거나 개별 Span 상세로 이동할 수 있습니다.

로그 조회 및 상세:

트레이스 조회 및 워터폴 차트:

이벤트 조회 및 상세:

RUM 조회 및 상세:

인시던트¶

'인시던트'는 현재 워크스페이스의 인시던트를 확인, 검색, 인계 및 추적하는 데 사용됩니다. 인시던트 목록은 상태별로 전환할 수 있으며, 일반적인 상태에는 미할당, 처리 중, 해결됨 등이 있습니다.

인시던트 목록에서 다음을 수행할 수 있습니다.

최근 시간 또는 정확한 시간 기준으로 인시던트 필터링
키워드 또는 key:value 조건 입력하여 인시던트 검색
검색 제안을 사용하여 제목, 등급, 상태, 사이트, 호스트, 처리자 등 필드 빠르게 선택
'나와 관련' 필터 활성화하여 사용자에게 알림이 전송된 인시던트, 사용자에게 할당된 인시던트 또는 사용자의 온콜 규칙과 관련된 인시던트를 우선 조회
길게 눌러 다중 선택 모드로 진입, 인시던트 상태 일괄 업데이트
워크스페이스 전환 및 현재 공간의 데이터 새로고침

인시던트 상세¶

인시던트 상세로 이동하면 인시던트의 핵심 정보, 상태 전환 및 문제 해결 컨텍스트를 확인할 수 있습니다. 상세 페이지는 다음을 지원합니다.

인시던트 제목, 등급, 상태, 처리자, 사이트, 탐지 차원 및 연결된 태그 확인
이벤트 분포 확인, 동일 인시던트의 상태별 분포 파악
인시던트를 처리 중으로 인계, 해결됨으로 표시, 재개 또는 처리 포기
상세, 필드, 협업 기록 등 구역별 내용 확인
협업 기록에서 작업 타임라인, 댓글 및 시스템 변경사항 확인, 댓글만 보기로 전환 가능
댓글 작성, @멘션으로 워크스페이스 멤버 언급, 첨부 파일 업로드
공유 또는 Handoff를 통해 모바일과 PC에서 동일한 인시던트 계속 확인

인시던트 푸시 또는 협업 @멘션 알림을 수신하면 알림을 클릭하여 해당 인시던트로 이동할 수 있습니다. 알림이 협업 댓글을 가리키는 경우 App이 협업 영역으로 이동하여 대상 댓글을 강조 표시합니다.

스케줄¶

'스케줄'은 현재 워크스페이스의 온콜 일정을 확인하는 데 사용됩니다. 월별로 온콜 그룹과 일일 온콜 멤버를 확인하고, 온콜 상세로 이동하여 현재 온콜, 다음 온콜 및 기록을 확인할 수 있습니다.

스케줄 페이지는 다음을 지원합니다.

현재 월 내 액세스 가능한 온콜 그룹 확인
오늘의 현재 온콜 담당자 확인
월별 캘린더에서 다른 날짜의 온콜 일정 확인
멤버 온콜 상세 열기, 온콜 중, 다음 온콜 및 온콜 기록 확인
멤버 온콜 연락처(휴대폰 번호, 이메일 등 구성된 정보) 확인
온콜 에스컬레이션 정책, 알림 계층, 알림 방식 및 알림 대상 확인, 알림이 온콜 멤버에게 어떻게 전달되는지 확인
워크스페이스 전환 및 스케줄 데이터 다시 로드

프로필¶

'프로필'은 계정, 상태, 워크스페이스 협업, 알림 및 App 설정을 관리하는 데 사용됩니다.

계정 및 상태¶

'프로필'에서 현재 계정, 이메일, 휴대폰 번호, 프로필 이미지 및 현재 워크스페이스를 확인할 수 있습니다. 또한 자신의 작업 상태를 설정하고 오늘의 온콜 개요를 확인할 수 있습니다. 온콜 상태는 온콜 일정에 따라 결정되며, App이 현재 온콜 일정과 결합하여 사용자가 온콜 중인지 여부를 표시합니다.

워크스페이스 전환¶

Guance App은 계정에 액세스 권한이 있는 모든 워크스페이스의 데이터를 확인하는 것을 지원합니다. 홈, 관측, 인시던트, 스케줄 또는 '프로필'에서 워크스페이스 선택기를 열고, 워크스페이스를 검색하여 전환할 수 있습니다.

현재 워크스페이스가 없다면 Guance 웹 버전으로 이동하여 새 워크스페이스 생성을 하거나, 다른 워크스페이스의 공간 관리자가 해당 워크스페이스의 새 멤버로 초대할 수 있습니다.

워크스페이스 멤버¶

'프로필' - '워크스페이스 멤버'에서 현재 워크스페이스의 멤버를 확인하고, 이름, 이메일 또는 계정으로 멤버를 검색하며, 멤버 상세를 확인할 수 있습니다. 인시던트 협업 댓글의 @멘션도 워크스페이스 멤버 정보를 사용합니다.

메시지 알림¶

Guance App은 워크스페이스 알림 및 인시던트 협업 기반의 모바일 푸시 기능을 제공합니다. '프로필' - '설정' - '푸시 설정'에서 시스템 알림 권한을 확인하고, App 푸시를 켜거나 끄고, 알림 기본 설정을 관리할 수 있습니다.

푸시 설정은 나와 관련된 인시던트만 알림, 미할당 인시던트 알림 수신, 처리 중 인시던트 상태 변경 알림 수신 등의 기본 설정을 지원합니다. 시스템 알림 권한이 활성화되지 않은 경우, iOS 시스템 설정으로 이동하여 알림을 허용해 주세요.

대시보드 바로가기¶

Guance App은 대시보드 데스크탑 바로가기 구성을 지원합니다. 구성 후, iOS 홈 화면에서 App 아이콘을 길게 눌러 지정된 대시보드를 직접 열 수 있습니다. 각 워크스페이스에서 최대 4개의 대시보드 바로가기를 구성할 수 있습니다.

'프로필' - '설정' - '대시보드 바로가기'에서 빠르게 조회할 대시보드를 검색하고 선택하거나, 선택한 바로가기의 순서를 조정하거나 더 이상 필요하지 않은 바로가기를 제거할 수 있습니다.

언어, 테마 및 계정 보안¶

'프로필' - '설정'에서 다음 항목을 구성할 수 있습니다.

언어 설정: 시스템 설정 따르기, 간체 중국어, 번체 중국어 또는 English 중 선택
테마 설정: 시스템 설정 따르기, 라이트 모드 또는 다크 모드 중 선택
계정 보안: 현재 로그인 방식, 사이트, 워크스페이스, 최근 로그인 시간 및 로컬 자격 증명 저장 설명 확인
디버그 정보: 로그인, 사이트 및 푸시 등록 문제 해결에 사용되는 기기 정보 확인 (토큰이나 키는 표시되지 않음)
로컬 데이터 및 캐시: 로컬 로그인 정보, 프로필 이미지 캐시를 삭제하거나 모든 로컬 데이터를 삭제
로그아웃: 현재 기기 세션을 종료하고 로그인 페이지로 돌아가기

공통 기능¶

시간 위젯¶

Guance App은 시간 위젯을 통해 홈 인시던트, 관측 조회 및 대시보드 표시의 시간 범위를 설정할 수 있습니다. 최근 1분, 5분, 15분, 1시간, 1일, 7일 등의 사전 설정 시간을 선택하거나, 시작 시간과 종료 시간을 선택하여 정확한 조회를 할 수 있습니다.

인시던트, 로그, 트레이스, 이벤트, RUM 및 대시보드 목록에서 검색 및 필터를 사용하여 대상 데이터를 빠르게 찾을 수 있습니다. 일부 페이지는 key:value 필드 조건, 필드 제안 및 값 제안을 지원합니다. 필드 필터에 대한 자세한 내용은 검색 설명 문서를 참조하세요.

Guance App은 인시던트 상세, 대시보드, 관측 데이터 상세 및 차트 확대 페이지에서 콘솔 링크를 공유할 수 있습니다. 페이지의 '공유' 버튼을 클릭하면 다른 협업 멤버에게 링크를 보낼 수 있습니다.

참고: 공유 링크 내용을 확인하려면 상대방도 공유된 내용이 속한 워크스페이스에 대한 액세스 권한이 필요합니다.

시나리오 1: PC로 공유

이 시나리오에서는 수신한 공유 링크를 클릭하여 PC에서 로그인하고 해당 데이터를 확인할 수 있습니다.

시나리오 2: Guance App이 설치된 iOS 또는 Android 모바일 기기로 공유

이 시나리오에서는 수신한 공유 링크를 클릭하여 App에서 해당 데이터 페이지를 열 수 있습니다. 대상 사이트가 현재 로그인된 사이트와 다른 경우, App이 사이트 전환 또는 재로그인을 안내합니다.

링크 이동¶

iOS 또는 Android 기기에 Guance App이 설치되어 있는 경우, 어디에서든 Guance의 웹 링크를 열면 App의 해당 콘텐츠 페이지로 이동할 수 있습니다. 여기에는 DingTalk, Lark, 메일의 알림도 포함됩니다.

현재 링크를 통해 인시던트, 대시보드, 로그, 트레이스, 이벤트 및 RUM 관련 페이지를 열 수 있습니다. 링크에 사이트 또는 워크스페이스 정보가 포함된 경우, App이 대상 컨텍스트로 이동을 시도합니다. 대상 사이트가 현재 로그인된 사이트와 다른 경우, App이 사이트 전환 및 재로그인을 안내합니다. 현재 계정에 대상 워크스페이스에 대한 액세스 권한이 없는 경우, 먼저 계정 권한을 확인하세요.

Handoff¶

Guance App은 Handoff를 통해 모바일과 PC 간에 인시던트 및 관측 데이터를 동기화하여 확인할 수 있도록 지원합니다. 알림 처리, 문제 해결 또는 협업 추적 시 기기를 빠르게 전환하는 데 도움을 줍니다.

참고: Handoff를 사용하려면 PC가 macOS, 모바일 기기가 iOS여야 하며, 각 기기에서 Handoff 기능을 활성화하고 동일한 Apple ID로 iCloud에 로그인해야 합니다. App이 설치 및 로그인되어 있어야 하며, 현재 계정에 대상 워크스페이스 권한도 필요합니다. 자세한 설정은 Handoff 사용 방법 문서를 참조하세요.

현재 Handoff를 지원하는 페이지는 다음과 같습니다. 인시던트 상세, 대시보드 상세, 확대된 대시보드 차트, 로그/이벤트/RUM 등 관측 레코드 상세, 트레이스 워터폴 차트 및 트레이스 Span 상세. App이 현재 페이지에 해당하는 콘솔 URL을 게시하여 다른 기기에서 동일한 데이터를 계속 확인할 수 있도록 합니다.

시나리오 1: 모바일에서 데이터를 확인하고 PC에서 계속 처리

이 시나리오에서는 모바일에서 Handoff를 지원하는 인시던트 또는 관측 데이터 페이지를 확인할 때, macOS의 Dock에 Guance App의 동기화 보기 알림이 나타납니다. 알림을 클릭하면 브라우저에서 해당 콘솔 페이지를 열 수 있습니다.

시나리오 2: PC에서 데이터를 확인하고 모바일에서 계속 처리

이 시나리오에서는 PC에서 모바일에서 열 수 있는 데이터 링크를 확인할 때, iOS 기기 하단에 Guance App의 동기화 보기 알림이 나타납니다. 알림을 클릭하면 App에서 해당 데이터 페이지를 열 수 있습니다. 대상 사이트 또는 워크스페이스가 현재 컨텍스트와 다른 경우, App이 사이트 전환, 재로그인 또는 워크스페이스 권한 확인을 안내합니다.

모바일¶

설치¶

홈¶