Concepts¶

Includes Guance components, features, client-side applications, mobile applications, versions, billing, and other term definitions.

Components¶

Guance components include the frontend console Studio, data gateway DataWay, data collection agent DataKit, and the extensible programming platform Func.

Component	Description
Studio	Studio is Guance's console, supporting comprehensive querying and analysis of collected data.
DataWay	DataWay is Guance's data gateway, mainly used for receiving data sent by DataKit, then reporting it to DataFlux for storage.
DataKit	DataKit is Guance's real-time data collection agent, supporting hundreds of types of data collection. After collecting data, DataKit sends it to the DataWay data gateway, which then reports it to the center for storage and analysis. DataKit needs to be deployed in the user's own IT environment and supports multiple operating systems. Default collection frequency: 5 minutes
Func	Func is DataFlux Func, Guance's extensible programming platform, used for function development, management, and execution. It is simple to use; just write code and publish it, automatically generating an HTTP API interface for functions. The official platform provides various ready-to-use script libraries that can easily be called by Guance.

Storage Engine Suite¶

Component	Description
GuanceDB	Refers to Guance's total suite of developed storage engines, including GuanceDB for metrics, GuanceDB for logs, and all sub-components in the suite.
GuanceDB for metrics	Guance's time-series metric engine, specifically used for storing and analyzing time-series metric data, including guance-select, guance-insert, and guance-storage three components.
GuanceDB for logs	Guance's non-time-series data storage and analysis engine, suitable for log, APM, RUM, and event data, including guance-select, guance-insert, and currently supported storage engine Doris.
guance-select	Guance's sub-component of the storage suite, responsible for querying and analyzing observable data.
guance-insert	Guance's sub-component of the storage suite, responsible for writing observable data.
guance-storage	Guance's time-series metric data storage engine, responsible for storing time-series metric data.
Doris	Guance's non-time-series data storage engine, suitable for log, APM, RUM, and event data.

Architecture diagram:

Features¶

Includes scenarios, events, infrastructure, metrics, logs, application performance monitoring, real-user monitoring, synthetic tests, security checks, etc., providing full-chain level data analysis and insight capabilities for collected data.

Feature	Description
Integrations	Guance supports over a hundred data collectors, including HOSTs, CONTAINERS, LOGS, Nginx, APM, RUM, etc. Just install DataKit to start real-time data collection and report it to Guance workspace for data analysis. You can check how to install Datakit, Func, DCA, MOBILE applications in integrations.
Scenarios	In scenarios, support visualized chart displays for collected data. Currently, three display methods are supported: Dashboards, Notes, and Explorers. Dashboard: Dashboards consist of multiple visual charts combined together for simultaneous viewing and analysis of theme-related data, obtaining more comprehensive information with adjustable layouts and chart sizes; Note: Notes consist of text documents and other visual charts, with fixed layouts from top to bottom. They can combine text and visuals for data analysis and summary reports; Explorer: Here you can quickly build a log explorer, supporting custom addition of statistical charts, default display attributes, and filtering conditions, tailoring your log viewing needs. Built-in Views: Includes two parts: System Views and User Views. System views are templates provided officially, while user views are created and saved as templates by users for scene and explorer details binding.
Events	Events are generated by monitors, intelligent inspections, SLOs, system operations, and Open APIs, supporting real-time monitoring, unified querying, unresolved event statistics, and data export based on event data, allowing tracing of abnormal situations at past time stages.
Infrastructure	Physical infrastructure for data collection, currently supporting HOSTs, CONTAINERS, processes, K8s entities, etc.
Metrics	Measurements: A collection of the same type of metrics, generally having the same labels within one measurement set, containing multiple metrics. Metrics: Metrics help understand the overall availability of a system, such as server CPU usage, website loading times, remaining disk space, etc. Metrics consist of a metric name and a metric value, where the metric name is an alias identifying the metric, and the metric value is the specific numerical value collected. Labels: A collection of attributes identifying a data point's collection object. Labels consist of label names and label values, and a data point can have multiple labels. For example, when collecting the `CPU Usage` metric, it will identify attributes such as `host`, `os`, `product`, etc., collectively referred to as labels. Time Series: In the current workspace, based on labels, all possible combinations reported in the metrics data. In Guance, time series are composed of metrics, labels (fields), and data storage duration, where "metrics" and "labels (fields)" combinations serve as the primary key for data storage.
Logs	Records real-time running or behavioral data generated during system or software operation, supporting front-end visualization, filtering, and analysis.
APM	Tracks and statistics the time spent handling service requests, request status, and other attribute information, used for application performance monitoring.
RUM	Real-user monitoring refers to collecting data related to the real experiences and behaviors of users interacting with your websites and applications. Guance supports four types of real-user monitoring: Web, MOBILE (Android & IOS), mini-programs.
Synthetic Tests	Utilizes globally distributed testing nodes to periodically monitor websites, domains, API interfaces, etc., via HTTP, TCP, ICMP protocols, supporting the analysis of site quality through trends in availability rates and latency changes.
Security Check	Conducts inspections on systems, software, logs, etc., using new security scripts, supporting real-time data output and synchronization of abnormal issues, understanding device operational conditions and environmental changes, discovering facility defects and safety hazards, and taking effective measures promptly.
CI	Guance supports visualization of Gitlab’s built-in CI processes and results, enabling you to view all CI visualized Pipelines and their success rates, failure reasons, specific failed steps, helping ensure code updates.
Monitoring	Monitors: By configuring detection rules, trigger conditions, and event notifications, receive alert notifications in real time, promptly identifying and resolving problems. Includes threshold detection, mutation detection, range detection, outlier detection, log detection, process anomaly detection, infrastructure survival detection, application performance metric detection, user access metric detection, security inspection anomaly detection, synthetic test anomaly detection, and network data detection. Intelligent Inspection: Based on Guance’s intelligent algorithms, automatically detects and predicts infrastructure and application issues, helping users discover problems occurring during IT system operation, quickly locating abnormal problem causes through root cause analysis. SLO: SLO monitoring revolves around DevOps-related metrics, testing whether system service availability meets target requirements, not only helping users monitor service provider quality but also protecting providers from SLA violations.
Workspaces	Guance data insights collaboration space, each workspace being independent. Users can query and analyze data within workspaces, supporting joining one or more workspaces through creation or invitation.
DQL	DQL (Debug Query Language) is Guance’s data query language. Users can use DQL query syntax within Guance to query metric-type/log-type data, then visualize the data in charts.
Pipeline	Pipeline is Guance’s data processing tool, defining parsing rules to split metrics, logs, RUM, APM, basic objects, RESOURCE CATALOGS, NETWORK, security inspections, etc., into structured data meeting requirements.

Client DCA¶

Client DCA (DataKit Control App) is an online DataKit management platform, supporting viewing DataKit operational status, and unified management and configuration of collectors, blacklists, Pipelines.

Mobile APP¶

Guance Mobile APP supports receiving alert notifications for events on mobile devices, viewing all scenario views and log data in workspaces, completing data analysis and insights anytime, anywhere.

Versions¶

Guance offers Free Plan, Commercial Plan, Deployment Plan in three versions.

Version	Description
Free Plan	Register to experience Guance feature modules.
Commercial Plan	Cloud-based SaaS public version, pay-as-you-go, ready-to-use, requiring only installation of DataKit and configuration of relevant data collectors to complete observability integration. For billing rules, refer to Billing Method.
Deployment Plan	Independent SaaS cloud deployment and local PaaS deployment, requiring users to prepare service resources themselves, offering the highest level of data security and more service support.

Billing¶

Guance provides a dedicated billing account management platform Billing Center, where you can recharge accounts, view account balances and bill details, bind workspaces, change settlement methods, etc.

For explanations of billing methods and items, refer to the document Billing Method.

Feature	Description
Settlement Methods	Guance fee settlement methods, supporting Guance enterprise accounts, cloud accounts, and various settlement methods. Guance enterprise account: Guance Billing Center is exclusively used to manage billing-related independent accounts for using Guance products, with one enterprise account able to associate billing for multiple workspaces. Cloud accounts: Guance Billing Center supports Amazon cloud accounts, Alibaba Cloud accounts, and Huawei Cloud accounts. Users can choose to bind cloud accounts for fee settlements.
Account Management	Guance Billing Center account management, including account profile changes, password modifications, real-name authentication, and cloud account management.
Workspace Management	Guance Billing Center account-bound workspace management, one account can bind multiple Guance workspaces. In workspace management, the settlement method for Guance workspaces can be modified.
Bill Management	Guance Billing Center bill management, including monthly bills, consumption details, income and expenditure details, voucher details, and package detail management.
Support Center	Guance Support Center, where users can submit and manage tickets, and Guance technical expert teams will contact users promptly to resolve issues after receiving tickets.