Settings API - Generic types schema table
Generic types (builtin:monitoredentities.generic.type)
Looking for topology extraction support? Find the topology model help page here.
A generic type allows to define rules for creating custom monitored entities based on ingest data.
| Schema ID | Schema groups | Scope |
|---|---|---|
builtin:monitoredentities.generic.type |
| environment |
| GET | Managed | https://{your-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:monitoredentities.generic.type |
| SaaS | https://{your-environment-id}.live.dynatrace.com/api/v2/settings/schemas/builtin:monitoredentities.generic.type | |
| Environment ActiveGate | https://{your-activegate-domain}/e/{your-environment-id}/api/v2/settings/schemas/builtin:monitoredentities.generic.type |
Authentication
To execute this request, you need an access token with Read settings (settings.read) scope. To learn how to obtain and use it, see Tokens and authentication.
Parameters
| Property | Type | Description | Required |
|---|---|---|---|
Enabledenabled | boolean | Enables or disables the type | required |
Type namename | text | The entity type name. This type name must be unique and must not be changed after creation. | required |
Type display namedisplayName | text | The human readable type name for this entity type. | required |
Created bycreatedBy | text | The user or extension that created this type. | required |
List of rulesrules | ExtractionRule[] | Specify a list of rules which are evaluated in order. When any rule matches, the entity defined according to that rule will be extracted. Subsequent rules will not be evaluated. Rules are evaluated in the order they appear in this list. Each rule defines how to create a single entity from ingested data. It defines properties like name, identifier and other attributes which are stored as part of that entity. A rule also describes filters which need to match the ingest data in order to create an entity. Many properties of an extraction rule use placeholders to dynamically evaluate and transform ingest data. Such rule properties are called patterns and allow combining dimension values with static text. The evaluated result is then used when extracting an entity. Each pattern may use multiple placeholders, each referring a single dimension key. During entity extraction, placeholders are replaced with the respective dimension values. Placeholders start with Example:
Example:
| required |
The ExtractionRule object
| Property | Type | Description | Required |
|---|---|---|---|
Extracted ID patternidPattern | text | ID patterns are comprised of static text and placeholders referring to dimensions in the ingest data. An ID pattern must contain at least one placeholder to ensure that different entities will be created. Take care that the pattern results in the same ID for the same entity. For example, using timestamp or counter-like dimensions as part of the ID would lead to the creation of new entities for each ingest data and is strongly discouraged! Each dimension key referred to by an identifier placeholder must be present in order to extract an entity. If any dimension key referred to in the identifier is missing, the rule will not be considered for evaluation. If you have cases where you still want to extract the same entity type but have differently named keys, consider creating multiple rules extracting the same entity type. In this case take care that each ID pattern evaluates to the same value if the same entity should be extracted. | required |
Instance name patterninstanceNamePattern | text | Define a pattern which is used to set the name attribute of the entity. You may define placeholders referencing data source dimensions. | optional |
Icon PatterniconPattern | text | Define a pattern which is used to set the icon attribute of the entity. The extracted values must reference barista icon ids. You may define placeholders referencing data source dimensions. | optional |
Source filterssources | Set<SourceFilter> | Specify all sources which should be evaluated for this rule. A rule is evaluated if any of the specified source filters match. | required |
Additionally required dimensionsrequiredDimensions | Set<DimensionFilter> | In addition to the dimensions already referred to in the ID pattern, you may specify additional dimensions which must be present in order to evaluate this rule. | required |
Attributesattributes | Set<AttributeEntry> | All attribute extraction rules will be applied and found attributes will be added to the extracted type. | required |
Rolerole | text | If you want to extract multiple entities of the same type from a single ingest line you need to define multiple rules with different roles. | optional |
The SourceFilter object
| Property | Type | Description | Required |
|---|---|---|---|
Ingest datasource typesourceType | enum | Specify the source type of the filter to identify which data source should be evaluated for ingest.
| required |
Conditioncondition | text | Specify a filter that needs to match in order for the extraction to happen. Three different filters are supported: | required |
The DimensionFilter object
| Property | Type | Description | Required |
|---|---|---|---|
Dimension keykey | text | A dimension key which needs to exist in the ingest data to match this filter. | required |
Dimension value patternvaluePattern | text | A dimension value pattern which needs to exist in the ingest data to match this filter. | optional |
The AttributeEntry object
| Property | Type | Description | Required |
|---|---|---|---|
Attribute keykey | text | The attribute key is the unique name of the attribute. | required |
Attribute display namedisplayName | text | The human readable attribute name for this extraction rule. Leave blank to use the key as the display name. | optional |
Attribute value extraction patternpattern | text | Pattern for specifying the value for the extracted attribute. Can be a static value, placeholders or a combination of both. | required |