모바일
---
icon: zy/mobile
---
# 모바일
---
Guance App은 모바일 기기에서 워크스페이스 내 인시던트, 관측 데이터, 온콜 일정, 계정 설정을 확인하고 처리할 수 있도록 지원합니다. App은 현재 '홈, 관측, 인시던트, 일정, 내 정보'의 다섯 가지 진입점을 중심으로 기능을 구성합니다. 알림 또는 협업 알림을 받은 후 인시던트 상세로 빠르게 이동하여 로그, 트레이스, 이벤트, RUM 및 대시보드 데이터를 확인하고, 상태 변경, 협업 댓글, 링크 공유, Handoff를 통해 문제를 계속 처리할 수 있습니다.
## 설치 {#app-install}
Guance 워크스페이스에서 '통합' - '모바일'을 통해 다운로드하거나 아래 QR 코드를 스캔하여 다운로드할 수 있습니다.
<img src="img/1.mobile_qrcode.png" width=300px />
또는 아래 링크를 클릭하여 직접 다운로드할 수도 있습니다.
- [ iOS 시스템 다운로드 ](https://apps.apple.com/cn/app/dataflux-mobile/id1494097190)
- [Android 시스템 다운로드](https://android.myapp.com/myapp/detail.htm?apkName=com.cloudcare.ft.dataflux.mobile&info=BC6B6D70A723FAA93DB84F11BF50AE8A)
## 로그인 {#login}
기존 Guance무료/상용 플랜 사용자는 App에서 계정이 속한 사이트를 선택하고 비밀번호, 휴대폰 인증번호 또는 SSO로 로그인할 수 있습니다. 사이트 목록은 현재 제품군에 따라 표시되며, 로그인 페이지에서 사이트 정보를 새로고침할 수도 있습니다.
- 비밀번호 로그인: 이메일 또는 계정과 비밀번호를 입력하여 로그인하며, 계정 기억을 선택할 수 있습니다.
- 인증번호 로그인: 휴대폰 번호와 6자리 인증번호를 입력하여 로그인하며, 인증번호 전송 전에 그래픽 인증을 완료해야 할 수 있습니다.
- SSO 로그인: 이메일 또는 전체 SSO 주소를 입력하고 페이지 안내에 따라 로그인 진입점과 워크스페이스를 선택하여 SSO를 완료합니다.
- 비밀번호 찾기: 비밀번호 로그인 페이지에서 비밀번호 재설정 절차를 진행하고 계정 인증을 완료한 후 새 비밀번호를 설정합니다.
- MFA: 워크스페이스에서 MFA 보안 정책을 활성화한 경우 로그인하거나 워크스페이스를 전환할 때 페이지 안내에 따라 인증을 완료해야 합니다. 최초 등록 시에도 등록 절차가 표시됩니다.
아직 Guance 계정이 없다면 Guance 공식 웹사이트에서 [지금 신청](https://auth.guance.com/register)을 클릭하여 적합한 사이트 계정을 등록할 수 있습니다.
로그인에 성공하면 App은 현재 계정으로 액세스 가능한 기본 워크스페이스로 진입합니다. 홈, 관측, 인시던트, 일정 또는 '내 정보'에서 워크스페이스를 전환할 수 있으며, 전환 후 해당 페이지의 데이터는 새 워크스페이스 기준으로 다시 로드됩니다.
### 프라이빗 사이트 로그인 {#private-site-login}
팀에서 프라이빗 배포 사이트를 사용하는 경우 로그인 페이지의 사이트 선택기에서 프라이빗 사이트를 추가하고 해당 사이트에서 로그인할 수 있습니다.
**프라이빗 사이트 추가**
1. 로그인 페이지에서 '사이트'를 클릭하여 사이트 선택기를 엽니다.
2. '프라이빗 사이트 추가'를 클릭합니다.
3. '대상 주소'에 프라이빗 사이트의 Console 주소 또는 사이트 디렉터리 주소를 입력합니다. 예: `https://console.company.com` 또는 `https://urls.company.com/`
4. '식별 및 미리보기'를 클릭하면 App이 사이트 이름, Console 주소, API 주소 및 지원되는 로그인 방식을 자동으로 식별합니다.
5. 사이트 이름을 확인한 후 '추가 및 저장'을 클릭합니다. 여러 사이트가 식별된 경우 페이지 안내에 따라 로그인 페이지의 기본 사이트를 선택합니다.
저장에 성공하면 프라이빗 사이트가 사이트 선택기의 '프라이빗' 그룹에 표시됩니다. 대상 사이트를 선택한 후 비밀번호, 인증번호 또는 SSO 로그인을 계속 사용할 수 있으며, 사용 가능한 로그인 방식은 해당 프라이빗 사이트의 구성에 따라 달라집니다.
<img src="img/1.mobile_private_site_add.jpg" width=320px />
**프라이빗 사이트 관리**
프라이빗 사이트를 추가한 후 로그인 페이지의 사이트 선택기에서 '프라이빗 사이트 관리'를 클릭하여 원격 디렉터리를 새로고침하고, 기본 사이트를 전환하고, 더 이상 사용하지 않는 구성을 삭제하거나 진단 정보를 복사하여 문제를 해결할 수 있습니다. 원격 디렉터리 새로고침에 실패하면 App은 마지막으로 동기화에 성공한 로컬 캐시를 우선 사용합니다.
<img src="img/1.mobile_private_site_picker.jpg" width=320px />
**사이트 디렉터리 주소 형식**
사이트 디렉터리 주소를 사용하는 경우 디렉터리 주소는 App에서 액세스 가능한 HTTPS URL이어야 합니다. 예: `https://urls.company.com/` 또는 `https://urls.company.com/site-map.json`. 프로토콜 없이 입력하거나 `http://` 주소를 입력하면 App은 `https://`로 변환한 후 액세스합니다. 해당 주소가 반환하는 내용은 JSON 객체여야 하며 최상위에 `urls` 필드가 포함되어야 합니다. `urls` 아래의 각 key는 하나의 사이트를 나타내며, 사이트 내에 Console 및 API 주소를 제공해야 합니다.
예시는 다음과 같습니다.
```json
{
"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 등의 유형으로 RUM 데이터를 확인하고 상세에서 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 선택
- 화면 모드 설정: 시스템 설정 따르기, 라이트 모드 또는 다크 모드 선택
- 계정 보안: 현재 로그인 방식, 사이트, 워크스페이스, 최근 로그인 시간 및 로컬 자격 증명 저장 설명 확인
- 디버그 정보: 로그인, 사이트, 푸시 등록 문제 해결에 사용되는 기기 정보 확인. token 또는 키는 표시하지 않음
- 로컬 데이터 및 캐시: 로컬 로그인 정보 및 프로필 이미지 캐시 삭제, 또는 전체 로컬 데이터 삭제
- 로그아웃: 현재 기기 세션을 종료하고 로그인 페이지로 복귀
공통 기능¶
시간 위젯¶
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의 Handoff 알림이 표시됩니다. 알림을 클릭하면 브라우저에서 해당 콘솔 페이지가 열립니다.
시나리오 2: PC에서 데이터를 확인하고 모바일에서 계속 처리
이 시나리오에서는 PC에서 모바일로 열 수 있는 데이터 링크를 보는 동안 iOS 기기 하단에 Guance App의 Handoff 알림이 표시됩니다. 알림을 클릭하면 App에서 해당 데이터 페이지가 열립니다. 대상 사이트 또는 워크스페이스가 현재 컨텍스트와 다른 경우 App은 사이트 전환, 재로그인 또는 워크스페이스 권한 확인을 안내합니다.
























