Remote monitoring in on-host integrations

From a New Relic perspective, entity is a broad concept. An entity is anything New Relic can identify that has data you can monitor.

Integrations can be configured to create their own entity, called remote entity, by setting the remote_monitoring option to true. If set to false, integration would be considered a local entity and the data related to it will be attached to the host entity that the agent creates.

For the Apache, Cassandra, MySQL, NGINX, and Redis integrations, remote monitoring (and multi-tenancy) is enabled by activating the configuration parameter remote_monitoring.

If your Apache, Cassandra, MySQL, NGINX, or Redis service is located in the same host as the agent, when you active remote monitoring the resulting entity will be considered as remote, regardless of its actual location, which may affect alerts or alter attributes, among others.

Remote monitoring requires Infrastructure agent version 1.2.25 or higher.

Effects of activating remote_monitoring

By enabling remote_monitoring, the integration becomes a different entity which is no longer attached to the infrastructure agent. As a result, the following items may be affected:

Verify your alerts

Enabling remote monitoring could affect your configured alerts in case they are using any of the values that are affected by this new feature.

We strongly recommend checking your existing alerts to make sure they keep on working as expected.

New entity attributes

These attributes are modified in the resulting entity:

  • Display name: New entity unique key (instead of using the display name)
  • Entity GUID: New entity GUID
  • Entity ID: New entity ID
  • Entity key: New entity unique key (instead of using the display name)
  • External key: Using integration entity name (instead of using the agent display)
Changes in collected metrics

When remote monitoring is enabled, we will add the hostname and port values to all metrics. If the nricluster name or nriservice are defined in the integration configuration file, they will also be decorated.

Some agent attributes may be lost

Since the integration is now an independent entity which is not attached to the agent anymore, the following agent attributes are not collected:

  • agentName
  • agentVersion
  • coreCount
  • criticalViolationCount
  • fullHostname
  • instanceType
  • kernelVersion
  • linuxDistribution
  • entityType
  • operatingSystem
  • processorCount
  • systemMemoryBytes
  • warningViolationCount

Custom attributes are not decorated either.

Updated hostname

For the ApacheSample, RedisSample, CassandraSample, and NginxSample integration metrics, we will use the integration configuration hostname instead of the short hostname from the agent.

When the integration hostname is a loopback address, the agent will replace it in order to guarantee uniqueness. Learn more in the loopback address replacement documentation.

For more help

Recommendations for learning more: