Frequently Asked Questions¶
Dashboard¶
How can I convert a Grafana dashboard JSON template to a Guance dashboard JSON template using a Node script?
npm download:
Usage:
$ npm install -g @cloudcare/guance-front-tools
# show usage information
$ grafanaCovertToGuance
# run task
$ grafanaCovertToGuance -d examples/grafana.json -o examples/guance.json
Keywords:
none
Explorer¶
Why can't I use JSON format in the Explorer search bar?
Using JSON search requires meeting the following three conditions:
- The site must be "China Region 1 (Hangzhou)", "China Region 3 (Zhangjiakou)", or "China Region 4 (Guangzhou)".
- The workspace must have been created after
June 23, 2022. - It can only be used in the Log Explorer.
Scheduled Reports¶
Why does the scheduled report email return a 414 error?
The image links in the final scheduled report sent to the target email are generated by iterating through the corresponding chart's view variables and other parameters in the dashboard and concatenating them. If the content of the view variables is too long, it may cause the generated image link to be too long, leading to a 414 error.
Built-in Views¶
Why is the detail page not displayed after binding?
Please check:
- Confirm you are binding a user view (system views need to be cloned first).
- Confirm the field name and
valuematch the data in the Explorer. - Check if the
valuematching pattern is correct (wildcard*vs. specific value).
Can one Explorer be bound to multiple views?
Yes. When multiple fields match different views, they are displayed in order of priority. If the same field matches multiple views, only the first one is displayed.
Why does my chart show "No data"?
Possible reasons:
- The selected time range is incorrect. Try expanding the time range.
- The filter conditions are too strict. Check if the tags and keywords are correct.
- Data has not been reported yet. Confirm the DataKit collector is running normally.
What does "Lock Time" mean in a chart?
Lock Time means the chart is fixed to query data from a specific time period and will not change with the dashboard's top time selector. It is suitable for comparing against historical baseline data.
What is the difference between a composite chart and a single chart?
A composite chart places multiple charts within the same card, viewable by switching tabs. It saves space and facilitates correlation analysis. It is suitable for comparing different dimensions of the same metric (e.g., TOP10 containers and TOP10 processes for CPU usage).
How do I configure view variables to make them effective?
After creating a view variable, you need to reference that variable in the chart query (e.g., host::tag) for the filter dropdown to appear in the top-right corner of the chart.
What should I do if others cannot open the shared chart link?
Check the sharing settings:
- Confirm you selected "Public Share" and not "Encrypted Share".
- Check if the link is still within its validity period.
- Confirm the other party's network can access the console.
Explorer¶
Why can't I use JSON format in the Explorer search bar?
Using JSON search requires meeting the following three conditions:
- The site must be "China Region 1 (Hangzhou)", "China Region 3 (Zhangjiakou)", or "China Region 4 (Guangzhou)".
- The workspace must have been created after
June 23, 2022. - It can only be used in the Log Explorer.
What are the use cases for Explorer versus Dashboard?
| Dimension | Dashboard | Explorer |
|---|---|---|
| Data Granularity | Aggregated data (trends, statistical values) | Detailed data (single logs, single traces) |
| Core Purpose | Monitoring overview, trend analysis, reporting, etc. | Troubleshooting, security auditing, data exploration, etc. |
| Interaction Mode | Visual charts, variable filtering, etc. | Search filtering, highlighting, context expansion, etc. |
Why are the filter conditions in Explorer and Dashboard not interconnected?
Filters in the Explorer only affect the current Explorer page, while filters in the Dashboard (view variables) affect all charts within that dashboard. They are independent.
Why does my chart show "No data"?
Possible reasons:
- The selected time range is incorrect. Try expanding the time range.
- The filter conditions are too strict. Check if the tags and keywords are correct.
- Data has not been reported yet. Confirm the DataKit collector is running normally.
What does "Lock Time" mean in a chart?
Lock Time means the chart is fixed to query data from a specific time period and will not change with the dashboard's top time selector. It is suitable for comparing against historical baseline data.
What is the difference between a composite chart and a single chart?
A composite chart places multiple charts within the same card, viewable by switching tabs. It saves space and facilitates correlation analysis. It is suitable for comparing different dimensions of the same metric (e.g., TOP10 containers and TOP10 processes for CPU usage).
How do I configure view variables to make them effective?
After creating a view variable, you need to reference that variable in the chart query (e.g., host::tag) for the filter dropdown to appear in the top-right corner of the chart.
What should I do if others cannot open the shared chart link?
Check the sharing settings:
- Confirm you selected "Public Share" and not "Encrypted Share".
- Check if the link is still within its validity period.
- Confirm the other party's network can access the console.
Explorer¶
Why can't I use JSON format in the Explorer search bar?
Using JSON search requires meeting the following three conditions:
- The site must be "China Region 1 (Hangzhou)", "China Region 3 (Zhangjiakou)", or "China Region 4 (Guangzhou)".
- The workspace must have been created after
June 23, 2022. - It can only be used in the Log Explorer.
What are the use cases for Explorer versus Dashboard?
| Dimension | Dashboard | Explorer |
|---|---|---|
| Data Granularity | Aggregated data (trends, statistical values) | Detailed data (single logs, single traces) |
| Core Purpose | Monitoring overview, trend analysis, reporting, etc. | Troubleshooting, security auditing, data exploration, etc. |
| Interaction Mode | Visual charts, variable filtering, etc. | Search filtering, highlighting, context expansion, etc. |
Why are the filter conditions in Explorer and Dashboard not interconnected?
Filters in the Explorer only affect the current Explorer page, while filters in the Dashboard (view variables) affect all charts within that dashboard. They are independent.
How can I quickly find all logs for a specific host?
In the Log Explorer search bar, enter host:hostname, or click the "View Logs" shortcut entry in the host list.
Scheduled Reports¶
Why does the scheduled report email return a 414 error?
The image links in the final scheduled report sent to the target email are generated by iterating through the corresponding chart's view variables and other parameters in the dashboard and concatenating them. If the content of the view variables is too long, it may cause the generated image link to be too long, leading to a 414 error.
What should I do if I don't receive the email after the report is sent?
Please check:
- Is the email address of the notification target correct?
- Has the email been intercepted and sent to the spam folder?
- Are there charts with excessively large data volumes in the dashboard causing generation failure?
Why are charts blank in the report?
This is usually due to the data query time range being too long or the chart calculation being too complex, causing a timeout. It is recommended to narrow the time range or simplify the query conditions.
Built-in Views¶
Why is the detail page not displayed after binding?
Please check:
- Confirm you are binding a user view (system views need to be cloned first).
- Confirm the field name and
valuematch the data in the Explorer. - Check if the
valuematching pattern is correct (wildcard*vs. specific value).
Can one Explorer be bound to multiple views?
Yes. When multiple fields match different views, they are displayed in order of priority. If the same field matches multiple views, only the first one is displayed.
Can the time range of a view be adjusted after binding?
The view defaults to showing the "Last 15 minutes", but you can manually adjust the time range within the view. This adjustment only affects the current view and is not saved.
Notes¶
Do charts inserted into Notes update data in real-time?
No. When a chart is inserted into a note, it saves the query results at that moment. Subsequent data changes are not automatically synchronized. To get the latest data, you need to re-insert the chart.
Can exported Note JSON be used in other workspaces?
Yes. Using the "Import Note JSON" function, you can migrate notes to other workspaces, but associated data sources need to be reconfigured.
Others¶
Explanation of P99 Peak Calculation Logic
Guance calculates P99 by obtaining all values of a metric over a period, sorting these values from smallest to largest, and then determining the position of the P99 data point based on number of data points * 99%, returning the value at that position. The "all values" mentioned here refer to the original data points stored in the database.
For percentile queries on metric data, Guance's processing method varies depending on the data engine used. If the database itself does not support percentile query functionality, Guance will pull the data locally through code for additional processing to achieve this. For non-metric data (such as logs, APM, RUM, etc.), percentile queries are supported by the database's native functionality.
What is the difference between a Snapshot and a Screenshot?
A Snapshot saves an interactive data state (supports switching time, drill-down analysis), while a Screenshot is just a static image. It is recommended to use Snapshots when sharing troubleshooting issues.