Since v1.2.1 we added support for custom devices import , starting with Nagios devices monitored using our Dynatrace Nagios Integration (we could cover also Dynatrace Zabbix Integration and/or custom devices made by other extensions).
Version v1.2.1 is the first version to require additional Dynatrace token scope
Read entities (API v2)
It’s used to fetch custom devices through Monitored entities V2 API.
Import configuration
We made greenfield start with fresh newly created schema as easy a it was before. Create predefined schema and Create predefined mappings options generate new schema together with custom device CI types and source objects mapping to their attributes.
Existing schema
In case you are using our extension for a while, custom device CI types and mappings have to be created manually in order to import them →
CI Types that have to be created:
Custom Device Group
Nagios Group
Custom Device
Nagios
Schema could look like this:
Updated schema structure
Object types mappings
Custom Device Group
Selector
CUSTOM_DEVICE_GROUP
Filter data source by IQL
No Value
Missing objects
Ignore
Missing objects outbound references
Ignore
Empty Values
Use default
Unknown Values
Use default
Match Identifier
Case sensitive
Mapping
ID
Data Locator
Insight Attribute
Object mapping (IQL)
ID
Data Locator
Insight Attribute
Object mapping (IQL)
displayName
Name
discoveredName
Discovered Name
customizedName
Customized Name
entityId
Entity ID
firstSeen
First Seen
lastSeen
Last Seen
calls
Calls
"Entity ID" in (${calls${0}})
runsOn
Runs On
"Entity ID" in (${runsOn${0}})
tags
Tags
"Entity ID" in (${tags${0}})
softwareTechnologies
Software Technologies
"Entity ID" in (${softwareTechnologies${0}})
isNetworkClientOfHost
Is Network Client Of Host
"Entity ID" in (${isNetworkClientOfHost${0}})
isNetworkClientOfPG
Is Network Client Of PG
"Entity ID" in (${isNetworkClientOfPG${0}})
managementZones
Management Zones
"Entity ID" in (${managementZones${0}})
isProcessOf
Is Process Of
"Entity ID" in (${isProcessOf${0}})
isInstanceOf
Is Instance Of
"Entity ID" in (${isInstanceOf${0}})
isNetworkClientOf
Is Network Client Of
"Entity ID" in (${isNetworkClientOf${0}})
runsOnPGI
Runs On PGI
"Entity ID" in (${runsOnPGI${0}})
dynatraceURL
Dynatrace URL
filterTags
Filter Tags
filterManagementZones
Filter Management Zones
filterHostGroups
Filter Host Groups
Nagios Group
Selector
NAGIOS_GROUP
Filter data source by IQL
No Value
Missing objects
Ignore
Missing objects outbound references
Ignore
Empty Values
Use default
Unknown Values
Use default
Match Identifier
Case sensitive
Mapping
ID
Data Locator
Insight Attribute
Object mapping (IQL)
ID
Data Locator
Insight Attribute
Object mapping (IQL)
displayName
Name
discoveredName
Discovered Name
customizedName
Customized Name
entityId
Entity ID
firstSeen
First Seen
lastSeen
Last Seen
calls
Calls
"Entity ID" in (${calls${0}})
runsOn
Runs On
"Entity ID" in (${runsOn${0}})
tags
Tags
"Entity ID" in (${tags${0}})
softwareTechnologies
Software Technologies
"Entity ID" in (${softwareTechnologies${0}})
isNetworkClientOfHost
Is Network Client Of Host
"Entity ID" in (${isNetworkClientOfHost${0}})
isNetworkClientOfPG
Is Network Client Of PG
"Entity ID" in (${isNetworkClientOfPG${0}})
managementZones
Management Zones
"Entity ID" in (${managementZones${0}})
isProcessOf
Is Process Of
"Entity ID" in (${isProcessOf${0}})
isInstanceOf
Is Instance Of
"Entity ID" in (${isInstanceOf${0}})
isNetworkClientOf
Is Network Client Of
"Entity ID" in (${isNetworkClientOf${0}})
runsOnPGI
Runs On PGI
"Entity ID" in (${runsOnPGI${0}})
dynatraceURL
Dynatrace URL
filterTags
Filter Tags
filterManagementZones
Filter Management Zones
filterHostGroups
Filter Host Groups
nagiosServer
Nagios server
Custom Device
Selector
CUSTOM_DEVICE
Filter data source by IQL
No Value
Missing objects
Ignore
Missing objects outbound references
Ignore
Empty Values
Use default
Unknown Values
Use default
Match Identifier
Case sensitive
Mapping
Nagios
Mapping
Imported Data
If the configuration was successfull you should see Nagis custom devices imported in your Dynatrace CMDB schema.