Custom devices import

Since v1.2.1 we added support for custom devices import , starting with Nagios devices monitored using our https://alanata.atlassian.net/wiki/spaces/DTNAGIOS (we could cover also https://alanata.atlassian.net/wiki/spaces/DTZABBIX and/or custom devices made by other extensions).

https://alanata.atlassian.net/wiki/spaces/DTNAGIOS is required to be installed in you Dynatrace instance

Required configuration changes

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 →

  1. 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.

 

Nagios References to existing infrastructure