MOBILE¶

Guance App supports viewing and handling incidents, observability data, on-call schedules, and account settings within your workspace on mobile devices. The App currently organizes capabilities around five entry points: "Home, Observe, Incident, Schedule, My". You can quickly enter incident details after receiving alerts or collaboration notifications, view logs, traces, events, RUM, and dashboard data, and continue handling issues through status transitions, collaboration comments, link sharing, and Handoff.

Installation¶

Within the Guance workspace, you can download the App via "Integration" - "Mobile", or scan the QR code below.

Alternatively, you can directly click the links below to download.

Existing Guance Free Plan/Commercial Plan users can select the site their account belongs to within the App and log in via password, mobile verification code, or SSO. The site list is displayed according to the current product line, and you can also refresh site information on the login page.

Password Login: Enter email or account, password to log in, with the option to remember the account.
Verification Code Login: Enter phone number and 6-digit verification code to log in. Completing a graphical verification may be required before sending the verification code.
SSO Login: Enter email or full SSO address, follow the page prompts to select the login entry, workspace, and complete single sign-on.
Forgot Password: Enter the password reset process on the password login page, set a new password after completing account verification.
MFA: When the workspace has MFA security policy enabled, logging in or switching workspaces requires completing verification as prompted. The binding process will also be shown during initial binding.

If you do not yet have a Guance account, you can go to the Guance official website to Apply Now and register an account for a suitable site.

After successful login, the App enters the default workspace accessible by the current account. You can switch workspaces from Home, Observe, Incident, Schedule, or "My". After switching, data on the corresponding pages will reload according to the new workspace.

Home¶

The Home page aggregates incidents that currently require attention, including unassigned incidents within the current workspace and incidents assigned to you that are not yet resolved. You can quickly perform the following operations on the Home page:

View incident name, severity, status, assignee, update time, and on-call information.
Select recent time or precise time range to locate incidents within a specific time period.
Pull down to refresh the incident list for the current workspace.
Long-press an incident to enter multi-select mode, batch take over, mark as resolved, or adjust incident status.
Click an incident card to enter the details page for further investigation and collaboration.
Switch workspaces and reload Home page data.

If there are no pending incidents in the current space, the Home page will display an empty state prompt.

Observe¶

"Observe" provides mobile query entry points for dashboards, logs, traces, events, and RUM. You can quickly view key data on mobile devices, or jump to corresponding data details from shared links or Handoff.

Dashboard¶

In "Observe" - "View Dashboards", you can view the list of accessible dashboards under the current workspace. Dashboards support searching by name, quick filtering, tag filtering, favoriting, and viewing creation/update information. After entering the dashboard details, you can:

View charts, tables, Top Lists, numerical values, text, and other components within the dashboard.
Use the Time Widget to switch between recent time or precise time ranges.
Adjust dashboard variables to switch data by dimensions such as service, host, application, etc.
Search component names to quickly locate target charts.
Switch between chart overview and chart reading mode, and expand or collapse charts by group.
Enlarge a single component and share or open the corresponding console link via Handoff.

Dashboards are synchronized with the web version. For details, refer to Dashboards.

Logs, Traces, Events, and RUM Queries¶

In "Observe", you can enter the log, trace, event, and RUM query pages respectively:

Logs: Supports selecting log indexes, querying log records by keyword or key:value conditions, and entering log details to view field content.
Traces: Supports querying Traces by trace_id, service, status, etc., and viewing Span call relationships with waterfall charts.
Events: Supports viewing key event details and locating events by event ID, monitor fields, etc.
RUM: Supports viewing user access data by types such as View, Action, Resource, Long Task, Error, and associating Traces or Resources in details.

Query pages support recent time, precise time, field suggestions, and value suggestions. After opening a record detail, you can view the summary, field list, raw content, and share console links. In Trace waterfall charts, you can also view associated RUM Resources or enter individual Span details. Log query and details:

Trace query and waterfall chart:

Event query and details:

RUM query and details:

Incident¶

"Incident" is used to view, search, claim, and track incidents within the current workspace. The incident list supports switching by status, common statuses include unassigned, in progress, resolved, etc.

In the incident list, you can:

Filter incidents by recent time or precise time.
Search incidents by keyword or key:value conditions.
Use search suggestions to quickly select fields such as title, severity, status, site, host, assignee, etc.
Enable "Related to Me" filter to prioritize incidents notified to you, assigned to you, or related to your on-call rules.
Long-press to enter multi-select mode and batch update incident status.
Switch workspaces and refresh data for the current space.

Incident Details¶

After entering incident details, you can view the core information, status transitions, and investigation context of the incident. The details page supports:

Viewing incident title, severity, status, assignee, site, detection dimensions, and associated tags.
Viewing event distribution to understand the distribution of the same incident under different statuses.
Taking over the incident as in progress, marking it as resolved, reopening it, or abandoning handling.
Viewing partitioned content such as details, fields, collaboration records, etc.
Viewing operation timelines, comments, and system changes in collaboration records, and switching to view comments only.
Writing comments, @mentioning workspace members, and uploading attachments.
Continuing to view the same incident on mobile or computer via sharing or Handoff.

When receiving incident push notifications or collaboration @mentions, you can click the notification to enter the corresponding incident. If the notification points to a collaboration comment, the App will locate to the collaboration area and highlight the target comment.

Schedule¶

"Schedule" is used to view on-call arrangements within the current workspace. You can view on-call groups and daily on-call members by month, and enter on-call details to confirm current on-call, next on-call, and historical records.

The Schedule page supports:

Viewing accessible on-call groups within the current month.
Viewing the current on-call person for the day.
Viewing on-call arrangements for different dates in the monthly calendar.
Opening member on-call details to view on-call status, next on-call, and on-call records.
Viewing member on-call contact information, including configured phone numbers and emails.
Viewing on-call escalation policies, notification levels, notification methods, and notification targets to confirm how alerts reach on-call members.
Switching workspaces and reloading schedule data.

My¶

"My" is used to manage account, status, workspace collaboration, notifications, and App settings.

Account and Status¶

In "My", you can view the current account, email, phone number, avatar, and current workspace. You can also set your own work status and view today's on-call overview. The on-call status is determined by the schedule, and the App will display whether you are currently on-call based on the current schedule.

Switching Workspaces¶

Guance App supports viewing data for all workspaces accessible by the account. You can open the workspace selector from Home, Observe, Incident, Schedule, or "My", search for workspaces, and switch.

If you currently have no workspace, you can go to the Guance web version to Create a New Workspace, or be Invited as a New Member to Other Spaces by other space administrators.

Workspace Members¶

In "My" - "Workspace Members", you can view current space members, search members by name, email, or account, and view member details. @mentions in incident collaboration comments also use workspace member information.

Message Notifications¶

Guance App provides mobile push capabilities based on workspace alerts and incident collaboration. You can view system notification permissions in "My" - "Settings" - "Push Settings", enable or disable App pushes, and manage notification preferences.

Push settings support preferences such as only notifying incidents related to me, receiving unassigned incident reminders, receiving in-progress incident status changes, etc. If system notification permissions are not enabled, please first allow notifications in iOS system settings.

Dashboard Shortcut Entry¶

Guance App supports configuring dashboard desktop shortcut entries. After configuration, you can long-press the App icon on the iOS home screen to directly open a specified dashboard. Each workspace can configure up to 4 dashboard shortcut entries.

You can search and select dashboards you want to quickly view via "My" - "Settings" - "Dashboard Shortcut Entries", or adjust the order of selected shortcut entries or remove entries no longer needed.

Language, Appearance, and Account Security¶

In "My" - "Settings", you can also configure the following:

Language Settings: Choose Follow System, Simplified Chinese, Traditional Chinese, or English.
Appearance Settings: Choose Follow System, Light, or Dark mode.
Account Security: View current login method, site, workspace, recent login time, and local credential storage description.
Debug Information: View device information used for troubleshooting login, site, and push registration, without displaying tokens or keys.
Local Data and Cache: Clear local login information, avatar cache, or all local data.
Logout: End the current device session and return to the login page.

Common Capabilities¶

Time Widget¶

Guance App supports setting time ranges for Home incidents, observability queries, and dashboard displays via the Time Widget. You can choose preset times such as Last 1 minute, 5 minutes, 15 minutes, 1 hour, 1 day, 7 days, etc., or select start and end times for precise queries.

In incident, log, trace, event, RUM, and dashboard lists, you can use search and filter to quickly locate target data. Some pages support key:value field conditions, field suggestions, and value suggestions. For more details on field filtering, refer to the documentation Search Instructions.

Guance App supports sharing console links from incident details, dashboards, observability data details, and enlarged chart pages. After clicking the "Share" button on the page, you can send the link to other collaboration members.

Note: When viewing shared link content, the recipient also needs to have access permissions to the workspace where the shared content resides.

Scenario 1: Share to PC

In this scenario, you can click the received share link to log in and view the corresponding data on the PC.

Scenario 2: Share to iOS or Android mobile devices with Guance App installed

In this scenario, you can click the received share link to open the corresponding data page in the App. If the target site differs from the currently logged-in site, the App will prompt you to switch sites or log in again.

Link Jump¶

If you have the Guance App installed on your iOS or Android device, you can jump to the corresponding content page in the App by opening any web link from Guance anywhere, including Alert Notifications from DingTalk, Lark, or emails.

Currently, opening incidents, dashboards, logs, traces, events, RUM, and related pages from links is supported. When the link contains site or workspace information, the App will attempt to enter the target context. If the target site differs from the currently logged-in site, the App will prompt to switch sites and log in again. If the current account lacks permission to access the target space, please verify account permissions first.

Handoff¶

Guance App supports synchronizing the viewing of incidents and observability data between mobile and computer via Handoff, helping you quickly switch devices when handling alerts, investigating issues, or collaborating.

Note: To use Handoff, the computer must be macOS, the mobile device must be iOS, Handoff must be enabled on each device, and the same Apple ID must be logged into iCloud. The App must be installed and logged into, and the current account must also have permissions for the target workspace. For more settings, refer to the documentation How to Use Handoff.

Pages currently supporting Handoff include: incident details, dashboard details, enlarged dashboard charts, observability record details (logs/events/RUM, etc.), trace waterfall charts, and trace Span details. The App publishes the corresponding console URL for the current page, facilitating continued viewing of the same data on another device.

Scenario 1: View data on mobile, continue handling on computer

In this scenario, when you view an incident or observability data page supporting Handoff on mobile, a synchronized viewing prompt for the Guance App will appear in the macOS Dock. Click the prompt to open the corresponding console page in the browser.

Scenario 2: View data on computer, continue handling on mobile

In this scenario, when you view a data link on the computer that can be opened on mobile, a synchronized viewing prompt for the Guance App will appear at the bottom of the iOS device. Click the prompt to open the corresponding data page in the App. If the target site or workspace differs from the current context, the App will prompt to switch sites, log in again, or confirm workspace permissions.

MOBILE¶

Installation¶

Home¶