Blog Feed Post

Register custom network devices in your Smartscape topology

Dynatrace OneAgent is a tremendously powerful tool for automatically collecting all important technology metrics and transactions within your environment. There are however certain situations where it’s not possible to install OneAgent directly on hosts (for example, 3rd party cloud platforms such as CloudDBs) or hardware appliances, such as routers, firewalls or data powers. Additionally, you may sometimes want to automatically send important metrics to custom network devices in your environment. In the latest Dynatrace release, we’ve enhanced our Dynatrace REST API to allow you to define custom monitored network devices and send custom metrics directly to custom network devices.

Register custom devices in Smartscape

Dynatrace intelligent problem detection depends on a well-structured topological model of your monitored environment. This topological model is updated in real time by installations of OneAgent that you deploy in your environment. By letting Dynatrace know about the IP addresses and ports of any custom network devices, Dynatrace Artificial intelligence can automatically map and position your custom device within our Smartscape topology (see Smartscape example below).

Register custom metrics

The Dynatrace API enables you to register new custom metrics by sending HTTP PUT requests to the timeseries REST endpoint, as shown in the example below:



"displayName" : "CPU temperature",

"unit" : "Count",

"dimensions": [



"types": [




The payload contains the display name, unit, and dimension key of the new metric. It’s important that the defined metric type be identical to the component type you’re sending the metric to. For example, if you define a custom entity of type Raspberry, you must also register all custom metrics for type Raspberry.

To confirm that a metric has been successfully registered, open the timeseries endpoint in your browser. Here you’ll see all the registered and exported timeseries metrics in your environment (see example below).

Send data points to a custom device

Once you’ve successfully registered a new metric in your environment, you can begin sending the data points to a custom defined network device.

You don’t need to register new custom devices, just use a unique ID within the URL and start sending meta information about the device and its metrics in regular intervals. It’s not necessary to send the meta info about a device with each data update. Dynatrace keeps all device info until updated info is received. You should send the device info in regular intervals, such as once per day in order to make sure that the network device always shows the most actual information.

Custom metric and network device example

Here is an example of how to create and update a new custom network device along with the metric registered in the example above:



with payload:


"displayName" : "Raspberry 42",

"ipAddresses" : [""],

"listenPorts" : [8080, 8090],

"type" : "Raspberry",

"favicon" : "http://assets.dynatrace.com/global/icons/cpu_processor.png",

"tags": ["user defined tag", "tag2"],

"properties" : { “prop1” : “propvalue” },

"series" : [

{ "timeseriesId" : "custom:test.firewall.droppedconnections",

"dimensions" : { "nic" : "ethernetcard1"  },

"dataPoints" : [ [ <timestamp>  , <value> ] ]





Custom metrics for dashboard tiles

Once you’ve started sending a metric to a custom device, you’ll find the metric available along with any other custom metrics that you’ve defined. Custom metrics can be used to construct custom charts and network-device specific dashboard tiles. For full details, see Can I use filtering to create more sophisticated dashboard charts?

Display in Smartscape

Custom metrics appear automatically in Smartscape on the host and process levels (see below). By providing information about a device’s network IP addresses and port numbers, Dynatrace listens to incoming communication from the device. Dynatrace topology discovery then attempts to automatically discover communication relations with other OneAgent monitored hosts and processes.

Click on a custom network device entry in Smartscape to view a generic entity page that displays all metrics you’ve sent to this custom device, along with any device properties and user tags that were sent via the Dynatrace API.

Ready to get started?

To begin creating your own custom devices and sending metrics into Dynatrace, please see the custom network device and metrics API documentation.

You can also find simple Python examples on Github to help you get started.

The post Register custom network devices in your Smartscape topology appeared first on Dynatrace blog – monitoring redefined.

Read the original blog entry...

More Stories By Dynatrace Blog

Building a revolutionary approach to software performance monitoring takes an extraordinary team. With decades of combined experience and an impressive history of disruptive innovation, that’s exactly what we ruxit has.

Get to know ruxit, and get to know the future of data analytics.

Latest Stories
SYS-CON Events announced today that N3N will exhibit at SYS-CON's @ThingsExpo, which will take place on Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. N3N’s solutions increase the effectiveness of operations and control centers, increase the value of IoT investments, and facilitate real-time operational decision making. N3N enables operations teams with a four dimensional digital “big board” that consolidates real-time live video feeds alongside IoT sensor data a...
Mobile device usage has increased exponentially during the past several years, as consumers rely on handhelds for everything from news and weather to banking and purchases. What can we expect in the next few years? The way in which we interact with our devices will fundamentally change, as businesses leverage Artificial Intelligence. We already see this taking shape as businesses leverage AI for cost savings and customer responsiveness. This trend will continue, as AI is used for more sophistica...
Today most companies are adopting or evaluating container technology - Docker in particular - to speed up application deployment, drive down cost, ease management and make application delivery more flexible overall. As with most new architectures, this dream takes significant work to become a reality. Even when you do get your application componentized enough and packaged properly, there are still challenges for DevOps teams to making the shift to continuous delivery and achieving that reducti...
Real IoT production deployments running at scale are collecting sensor data from hundreds / thousands / millions of devices. The goal is to take business-critical actions on the real-time data and find insights from stored datasets. In his session at @ThingsExpo, John Walicki, Watson IoT Developer Advocate at IBM Cloud, will provide a fast-paced developer journey that follows the IoT sensor data from generation, to edge gateway, to edge analytics, to encryption, to the IBM Bluemix cloud, to Wa...
What is the best strategy for selecting the right offshore company for your business? In his session at 21st Cloud Expo, Alan Winters, U.S. Head of Business Development at MobiDev, will discuss the things to look for - positive and negative - in evaluating your options. He will also discuss how to maximize productivity with your offshore developers. Before you start your search, clearly understand your business needs and how that impacts software choices.
Enterprises are moving to the cloud faster than most of us in security expected. CIOs are going from 0 to 100 in cloud adoption and leaving security teams in the dust. Once cloud is part of an enterprise stack, it’s unclear who has responsibility for the protection of applications, services, and data. When cloud breaches occur, whether active compromise or a publicly accessible database, the blame must fall on both service providers and users. In his session at 21st Cloud Expo, Ben Johnson, C...
Most of the time there is a lot of work involved to move to the cloud, and most of that isn't really related to AWS or Azure or Google Cloud. Before we talk about public cloud vendors and DevOps tools, there are usually several technical and non-technical challenges that are connected to it and that every company needs to solve to move to the cloud. In his session at 21st Cloud Expo, Stefano Bellasio, CEO and founder of Cloud Academy Inc., will discuss what the tools, disciplines, and cultural...
SYS-CON Events announced today that Fusic will exhibit at the Japan External Trade Organization (JETRO) Pavilion at SYS-CON's 21st International Cloud Expo®, which will take place on Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. Fusic Co. provides mocks as virtual IoT devices. You can customize mocks, and get any amount of data at any time in your test. For more information, visit https://fusic.co.jp/english/.
SYS-CON Events announced today that Massive Networks, that helps your business operate seamlessly with fast, reliable, and secure internet and network solutions, has been named "Exhibitor" of SYS-CON's 21st International Cloud Expo ®, which will take place on Oct 31 - Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. As a premier telecommunications provider, Massive Networks is headquartered out of Louisville, Colorado. With years of experience under their belt, their team of...
21st International Cloud Expo, taking place October 31 - November 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA, will feature technical sessions from a rock star conference faculty and the leading industry players in the world. Cloud computing is now being embraced by a majority of enterprises of all sizes. Yesterday's debate about public vs. private has transformed into the reality of hybrid cloud: a recent survey shows that 74% of enterprises have a hybrid cloud strategy. Me...
SYS-CON Events announced today that Enroute Lab will exhibit at the Japan External Trade Organization (JETRO) Pavilion at SYS-CON's 21st International Cloud Expo®, which will take place on Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. Enroute Lab is an industrial design, research and development company of unmanned robotic vehicle system. For more information, please visit http://elab.co.jp/.
SYS-CON Events announced today that MIRAI Inc. will exhibit at the Japan External Trade Organization (JETRO) Pavilion at SYS-CON's 21st International Cloud Expo®, which will take place on Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. MIRAI Inc. are IT consultants from the public sector whose mission is to solve social issues by technology and innovation and to create a meaningful future for people.
With the rise of DevOps, containers are at the brink of becoming a pervasive technology in Enterprise IT to accelerate application delivery for the business. When it comes to adopting containers in the enterprise, security is the highest adoption barrier. Is your organization ready to address the security risks with containers for your DevOps environment? In his session at @DevOpsSummit at 21st Cloud Expo, Chris Van Tuin, Chief Technologist, NA West at Red Hat, will discuss: The top security r...
IBM helps FinTechs and financial services companies build and monetize cognitive-enabled financial services apps quickly and at scale. Hosted on IBM Bluemix, IBM’s platform builds in customer insights, regulatory compliance analytics and security to help reduce development time and testing. In his session at 21st Cloud Expo, Lennart Frantzell, a Developer Advocate with IBM, will discuss how these tools simplify the time-consuming tasks of selection, mapping and data integration, allowing devel...
SYS-CON Events announced today that Mobile Create USA will exhibit at the Japan External Trade Organization (JETRO) Pavilion at SYS-CON's 21st International Cloud Expo®, which will take place on Oct 31 – Nov 2, 2017, at the Santa Clara Convention Center in Santa Clara, CA. Mobile Create USA Inc. is an MVNO-based business model that uses portable communication devices and cellular-based infrastructure in the development, sales, operation and mobile communications systems incorporating GPS capabi...