Mobile¶

The Guance App supports viewing and handling incidents, observability data, on-call schedules, and account settings within workspaces on mobile devices. The App is organized around five entries: "Home, Observe, Incidents, On-Call, and My". After receiving alert or collaboration notifications, you can quickly enter the incident details, view logs, traces, events, RUM, and dashboard data, and continue handling issues through status transitions, collaboration comments, shared links, and Handoff.

Installation¶

In a Guance workspace, you can download the App through "Integrations" - "Mobile", or by scanning the QR code below.

Or you can directly click the links below to download.

Existing GuanceFree/Commercial Plan users can select the site their account belongs to in the App and log in with a password, phone 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 your email or account and password to log in. You can choose to remember the account;
Verification code login: Enter your phone number and 6-digit verification code to log in. A graphic verification may be required before sending the code;
SSO login: Enter your email or full SSO address, then select the login entry and workspace as prompted to complete single sign-on;
Forgot password: Start the reset password flow on the password login page, complete account verification, and set a new password;
MFA: When the workspace enables the MFA security policy, you must complete verification as prompted when logging in or switching workspaces. The binding flow is also displayed during first-time binding.

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

After a successful login, the App enters the default workspace accessible to the current account. You can switch workspaces from Home, Observe, Incidents, On-Call, or My. After switching, the data of the corresponding pages is reloaded according to the new workspace.

If your team uses a privately deployed site, you can add the private site in the site selector on the login page and complete login under the corresponding site.

Add a Private Site

On the login page, tap "Site" to open the site selector;
Tap "Add Private Site";
In "Target Address", enter the Console address of the private site or the site directory address, such as https://console.company.com or https://urls.company.com/;
Tap "Recognize & Preview". The App automatically recognizes the site name, Console address, API address, and supported login methods;
After confirming the site name, tap "Add & Save". If multiple sites are recognized, select the default site used by the login page as prompted.

After saving, the private site appears in the "Private" group of the site selector. After selecting the target site, you can continue to log in with a password, verification code, or SSO. The available login methods depend on the configuration of that private site.

Manage Private Sites

After adding a private site, you can tap "Manage Private Sites" in the site selector on the login page to refresh the remote directory, switch the default site, delete configurations no longer in use, or copy diagnostic information for troubleshooting. If the remote directory refresh fails, the App uses the last successfully synced local cache.

Site Directory Address Format

If you use a site directory address, it must be an HTTPS URL accessible by the App, such as https://urls.company.com/ or https://urls.company.com/site-map.json. If you enter an address without a protocol or enter an http:// address, the App converts it to https:// before accessing. The content returned by this address must be a JSON object with a top-level urls field. Each key under urls represents a site, and each site must provide Console and API addresses.

Example:

{
  "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"
    }
  }
}

Here, name and name_en are used to display the site name; console is the web console address; console_api is the business API address.

Note: The private site address must be accessible via HTTPS in the current network environment. If recognition fails, confirm whether the address is a valid Console address or site directory address, and check the network, VPN, certificates, and site configuration.

Home¶

Home aggregates the incidents that currently need attention, including unassigned incidents in the current workspace and incidents assigned to you that have not yet been resolved. On Home, you can quickly perform the following operations:

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

If there are no incidents to handle in the current workspace, Home shows an empty state.

Observe¶

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

Dashboards¶

In "Observe" - "View Dashboards", you can view the list of dashboards accessible in the current workspace. The dashboard list supports searching by name, quick filters, tag filters, favorites, and viewing creation/update information. After entering the dashboard details, you can:

View components in the dashboard, such as charts, tables, top lists, values, and text;
Use the time widget to switch between recent time and precise time ranges;
Adjust dashboard variables to switch data by dimensions such as service, host, and application;
Search component names to quickly locate the target chart;
Switch between chart overview and chart reading mode, and expand or collapse charts by group;
Enlarge a single component, and share it or open the corresponding console link via Handoff.

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

Log, Trace, Event, and RUM Queries¶

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

Logs: Select a log index and query log records by keyword or key:value conditions, then enter the log details to view field content;
Traces: Query traces by conditions such as trace_id, service, and status, and view Span call relationships in a waterfall chart;
Events: View key event details and locate events by conditions such as event ID and monitor fields;
RUM: View user access data by type such as View, Action, Resource, Long Task, and Error, and associate traces or resources in the details.

The query pages support recent time, precise time, field suggestions, and value suggestions. After opening a record detail, you can view the summary, field list, and raw content, and share the console link. In the Trace waterfall chart, you can also view the associated RUM Resource or enter a single Span detail.

Log query and details:

Trace query and waterfall chart:

Event query and details:

RUM query and details:

Incidents¶

"Incidents" is used to view, search, claim, and track incidents in the current workspace. The incident list supports switching by status. Common statuses include Unassigned, In Progress, Resolved, and so on.

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, and assignee;
Enable the "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 statuses;
Switch workspaces and refresh the data of the current workspace.

Incident Details¶

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

Viewing the 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 it;
Viewing sections such as Details, Fields, and Collaboration Records;
Viewing the operation timeline, 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 and desktop through Share or Handoff.

When you receive an incident push or a collaboration @ mention, you can tap the notification to enter the corresponding incident. If the notification points to a collaboration comment, the App locates the collaboration area and highlights the target comment.

On-Call¶

"On-Call" is used to view the on-call schedule in the current workspace. You can view on-call groups and daily on-call members by month, and enter on-call details to confirm the current on-call, the next on-call, and the history.

The On-Call page supports:

Viewing the on-call groups accessible within the current month;
Viewing who is currently on call today;
Viewing the on-call schedule for different dates in the monthly calendar;
Opening a member's on-call details to view the current on-call, next on-call, and on-call records;
Viewing the member's on-call contact information, including configured phone numbers and email addresses;
Viewing the on-call escalation policy, notification levels, notification methods, and notification targets to confirm how alerts reach on-call members;
Switching workspaces and reloading on-call data.

My¶

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

Account & Status¶

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

Switching Workspaces¶

The Guance App supports viewing data of all workspaces that your account has permission to access. You can open the workspace selector from Home, Observe, Incidents, On-Call, or My, search for a workspace, and switch to it.

If you currently have no workspace, you can go to the Guance web version to create a new workspace, or have a workspace administrator of another workspace invite you as a new member.

Workspace Members¶

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

Notifications¶

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

Push settings support preferences such as notifying only incidents related to me, receiving reminders for unassigned incidents, and receiving status change notifications for incidents in progress. If system notification permission is not enabled, go to iOS system settings to allow notifications first.

Dashboard Shortcuts¶

The Guance App supports configuring dashboard home screen shortcuts. After configuration, you can long-press the App icon on the iOS Home Screen to directly open the specified dashboard. Each workspace can have up to 4 dashboard shortcuts configured.

You can search and select dashboards for quick access in "My" - "Settings" - "Dashboard Shortcuts", adjust the order of selected shortcuts, or remove shortcuts no longer needed.

Language, Appearance & Account Security¶

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

Language: Choose Follow System, Simplified Chinese, Traditional Chinese, or English;
Appearance: Choose Follow System, Light, or Dark mode;
Account Security: View the current login method, site, workspace, last login time, and a description of local credential storage;
Debug Information: View device information used for troubleshooting login, site, and push registration. Tokens or keys are not displayed;
Local Data & Cache: Clear local login information and avatar cache, or clear all local data;
Sign Out: End the current device session and return to the login page.

Common Capabilities¶

Time Widget¶

The Guance App supports setting the time range for Home incidents, observe queries, and dashboard views through the time widget. You can select preset ranges such as the last 1 minute, 5 minutes, 15 minutes, 1 hour, 1 day, or 7 days, or select a start time and end time for a precise query.

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

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

Note: To view the content of a shared link, the recipient also needs access permission to the workspace where the shared content resides.

Scenario 1: Share to a PC

In this scenario, tap the received shared link to log in on the PC and view the corresponding data.

Scenario 2: Share to an iOS or Android mobile device with the Guance App installed

In this scenario, tap the received shared link to open the corresponding data page in the App. If the target site is different from the current login site, the App prompts you to switch sites or log in again.

Link Navigation¶

If the Guance App is installed on your iOS or Android device, opening any web link from Guance anywhere will navigate to the page of the corresponding content in the App, including Alert Notifications from DingTalk, Lark, and email.

Currently, pages for incidents, dashboards, logs, traces, events, RUM, and related content can be opened from links. When the link contains site or workspace information, the App tries to enter the target context. If the target site is different from the current login site, the App prompts you to switch sites and log in again. If the current account does not have permission to access the target workspace, confirm the account permission first.

Handoff¶

The Guance App supports Handoff to synchronize the viewing of incidents and observability data between mobile and desktop, helping you quickly switch devices when handling alerts, troubleshooting, or following up on collaboration.

Note: To use Handoff, the desktop must be running macOS, the mobile device must be running iOS, each device must have Handoff enabled, and all devices must be signed in to iCloud with the same Apple ID. The App must be installed and signed in, and the current account must have permission to the target workspace. For more settings, refer to the document How to use Handoff.

Pages that currently support Handoff include incident details, dashboard details, enlarged dashboard charts, observability record details such as logs/events/RUM, trace waterfall charts, and trace Span details. The App publishes the console URL of the current page so you can continue viewing the same data on another device.

Scenario 1: View data on mobile and continue on the desktop

In this scenario, when you view a Handoff-enabled incident or observability data page on mobile, a sync view prompt for the Guance App appears in the macOS Dock. After tapping the prompt, the corresponding console page opens in the browser.

Scenario 2: View data on desktop and continue on mobile

In this scenario, when you view a data link on the desktop that can be opened on mobile, a sync view prompt for the Guance App appears at the bottom of the iOS device. After tapping the prompt, the corresponding data page opens in the App. If the target site or workspace is different from the current context, the App prompts you to switch sites, log in again, or confirm workspace permissions.

Mobile¶

Installation¶

Home¶