Resource Catalog¶
In addition to hosts, containers, and processes, you can create custom resources by combining properties, associated views, JSON text configurations, and using the DataKit API and DataFlux Func to report any data to Guance, including cloud vendor cloud resource data, various business data of enterprises, and other arbitrary data that needs monitoring. Ultimately, this data is managed and analyzed in a unified visual manner through the custom resource Explorer in the front-end console.
By creating viewer templates that conform to the characteristics of different resource classes, once the data is connected to the console, it will prioritize applying the created templates. You can use these viewer templates to view and analyze Resource Catalog data. If no match is found, the official template library's templates will be applied.
Note:
- Whether or not a resource has a viewer template does not affect the reporting and reception of data;
- Templates support configuring "mandatory attributes," meaning the data must include these fields for it to be received, which can be used for data filtering and interception.
Data Reporting¶
Prerequisite: Install DataKit and DataFlux Func.
After adding resource catalog classifications, you can proceed with custom data reporting. Report data from DataFlux Func to DataKit, which ultimately reports the data to the Guance workspace.
For detailed steps, refer to Resource Catalog Data Reporting.
Note:
- Custom fields in mandatory attributes are required fields when reporting data. If the reported data lacks these required fields, it will not be reported to the Guance workspace;
- If the data type of the reported data does not match the defined field data type, it will not be reported to the Guance workspace. For example, if the field type is defined as string in DataFlux Func but the data type reported is integer, this data will not be reported to the Guance workspace;
- Resource catalogs offline for 48 hours will be cleared.
Create a Resource Viewer¶
You can create a viewer in the following ways:
Custom Creation: Click to directly enter the creation page.
Import Viewer Template: Import a template and then edit it.
Start Configuration¶
Default Configuration¶
- Choose whether to group resources as needed;
- Define the resource class name for resource catalog data reporting;
- Mandatory Attributes: Fields that must be included in the data; the
name
field of the object is added by default. If the reported data does not contain the fields you set, it will not be reported to Guance, thus filtering out non-conforming data; - Enter an alias for the resource class, which will be displayed preferentially in the list after configuration;
- Viewer Display Configuration:
- Default Columns: The headers displayed by default in the viewer table;
- Default Quick Filters: The filter fields displayed by default in the quick filters on the left side of the viewer;
- Detail Page Associated Views: Define the display name of the view, select the view, and fill in the associated fields as needed to bind built-in views or pages;
- Color Fill Fields: A list of fields used for color filling in hexagonal map mode; if not configured, all numeric fields are listed by default;
- Group Analysis Fields: A list of fields that can be selected for group analysis in hexagonal map mode; if not configured, all string fields are listed by default;
- Click Confirm.
Note:
- Built-in views include all views; if there are duplicates, user views take precedence over system views;
- Built-in pages include viewer lists (such as logs, traces, containers), network topology, and other page templates.
JSON Configuration¶
When switching from default configuration to JSON configuration, choose:
- Yes: Automatically carry over the current content to JSON configuration;
-
No: Only basic configuration is provided when entering JSON mode.
-
Choose whether to group resources as needed;
- Add mandatory attributes;
- Modify JSON configuration as needed;
- Click Confirm.
Resource Classes¶
In the resource class list on the left side of the page, you can perform the following operations:
- In the search bar, input the resource name for quick location;
- Click the button:
- Modify or export existing object classes;
- Delete the viewer template;
- Add the resource class to a secondary menu for easier viewing.
- Click the expand/collapse button to hide the resource class to meet display preferences.
- Add Groups: Categorize resource viewers. After adding, click the button on the right side of a single resource to move the current resource to the target group.
- Click the button on the right side of the group to modify the group name;
- Delete groups and choose whether to "only delete the group" or "synchronously delete all viewer templates under the group."
Note: Adding fields does not change existing object data; newly reported data must include the added fields.
Delete¶
Deleting a viewer template here does not delete the data. If data continues to be reported, it will automatically apply the default viewer template.
If you want to completely delete the data, go to Manage > Delete Resource Catalog to perform the deletion operation.
- Specific Resource Catalog Classifications: Only delete data under the selected object classification without deleting indexes;
- All Resource Catalogs: Delete all resource catalog data and indexes.
Note:
- Only Owners and Administrators can perform deletion operations;
- Once all resource catalogs are deleted, all data and indexes reported to custom infrastructure will be deleted and cannot be recovered. All settings for resource catalog classification data need to be re-reported, with a limit of 5 deletions per day.
Cross-Workspace Query¶
Select all workspaces associated with your account to query resource list data across spaces.
Resource Catalog Viewer¶
View and analyze resource catalogs in list or hexagonal map form.
Quick Filter¶
You can add filter items to the resource catalog.
Note: Space-level filter items can only be added by the current workspace Owner and Administrator.
- Click the Add Space-Level Filter Item button;
- Search or directly add fields in the dropdown box;
- Click Confirm.
For more details, refer to Viewer Quick Filters.
Detail Page¶
After resource catalog data is reported, clicking the name in the right-side viewer resource catalog list will slide out a detail page showing detailed information about the object, including object name, extended attributes, and associated views.
Basic Attributes¶
View all attribute fields attached to the resource catalog data.
Associated Views¶
Set up binding or removal of built-in views (system views, user views) to the infrastructure resource catalog detail page.
Note: Before binding built-in views, ensure that the view variables in the bound built-in view contain fields related to the resource catalog, such as host
.