Skip to content

Sending New Relic data to Datable

New Relic

Datable supports ingesting directly from New Relic application agents. To support the transition of customers from sending data directly to New Relic, Datable will defaults to proxying all New Relic data directly to New Relic, ensuring that data flow is not interrupted during initial onboarding and testing.

Redirecting data is configuring by either environment variables or configuration.

Environment variables:

yaml
NEW_RELIC_HOST: YOUR_DATABLE_HOST.dtbl.io
NEW_RELIC_PORT: 5401
NEW_RELIC_HOST: YOUR_DATABLE_HOST.dtbl.io
NEW_RELIC_PORT: 5401

Configuration file variables:

Both host and port need to be set in your newrelic.yml file.

yaml
host: YOUR_DATABLE_HOST.dtbl.io
port: 5401
host: YOUR_DATABLE_HOST.dtbl.io
port: 5401

If you’re using the New Relic agent, you can update your existing configuration with these variables. The most common places for these configurations is the newrelic-infra.yml or environment variables in the system your agent is running on, such as your Docker container, Kubernetes container, or bare EC2 instance. For more information on where to configure these settings, please review the New Relic infrastructure agent configuration documentation.

If you’re using New Relic APM agents, these settings can be configured in your New Relic configuration file (newrelic.yml, newrelic.js, newrelic.config, ect.) or via environment variables on your application container. For configuration information specific to your application’s language, see the New Relic APM agents configurations.

Full example

yaml
#
# This file configures the New Relic Agent.  New Relic monitors Ruby, Java,
# .NET, PHP, Python, Node, and Go applications with deep visibility and low
# overhead.  For more information, visit www.newrelic.com.
#
# Generated October 28, 2022
#
# This configuration file is custom generated for NewRelic Administration
#
# For full documentation of agent configuration options, please refer to
# https://docs.newrelic.com/docs/agents/ruby-agent/installation-configuration/ruby-agent-configuration

common: &default_settings
  # Required license key associated with your New Relic account.
  license_key: 'ABC123'

  # Send traffic to Datable
  host: YOUR_DATABLE_HOST.dtbl.io
  port: 5401

  # Your application name. Renaming here affects where data displays in New
  # Relic.  For more details, see https://docs.newrelic.com/docs/apm/new-relic-apm/maintenance/renaming-applications
  app_name: 'whataloaf'

  distributed_tracing:
    enabled: true

  # To disable the agent regardless of other settings, uncomment the following:

  # agent_enabled: false

  # Logging level for log/newrelic_agent.log
  log_level: info

  application_logging:
    # If `true`, all logging-related features for the agent can be enabled or disabled
    # independently. If `false`, all logging-related features are disabled.
    enabled: true
    forwarding:
      # If `true`, the agent captures log records emitted by this application.
      enabled: true
      # Defines the maximum number of log records to buffer in memory at a time.
      max_samples_stored: 10000
    metrics:
      # If `true`, the agent captures metrics related to logging for this application.
      enabled: true
    local_decorating:
      # If `true`, the agent decorates logs with metadata to link to entities, hosts, traces, and spans.
      # This requires a log forwarder to send your log files to New Relic.
      # This should not be used when forwarding is enabled.
      enabled: false

# Environment-specific settings are in this section.
# RAILS_ENV or RACK_ENV (as appropriate) is used to determine the environment.
# If your application has other named environments, configure them here.
development:
  <<: *default_settings
  app_name: 'whataloaf (Development)'

test:
  <<: *default_settings
  # It doesn't make sense to report to New Relic from automated test runs.
  monitor_mode: false

staging:
  <<: *default_settings
  app_name: 'whataloaf (Staging)'

production:
  <<: *default_settings
#
# This file configures the New Relic Agent.  New Relic monitors Ruby, Java,
# .NET, PHP, Python, Node, and Go applications with deep visibility and low
# overhead.  For more information, visit www.newrelic.com.
#
# Generated October 28, 2022
#
# This configuration file is custom generated for NewRelic Administration
#
# For full documentation of agent configuration options, please refer to
# https://docs.newrelic.com/docs/agents/ruby-agent/installation-configuration/ruby-agent-configuration

common: &default_settings
  # Required license key associated with your New Relic account.
  license_key: 'ABC123'

  # Send traffic to Datable
  host: YOUR_DATABLE_HOST.dtbl.io
  port: 5401

  # Your application name. Renaming here affects where data displays in New
  # Relic.  For more details, see https://docs.newrelic.com/docs/apm/new-relic-apm/maintenance/renaming-applications
  app_name: 'whataloaf'

  distributed_tracing:
    enabled: true

  # To disable the agent regardless of other settings, uncomment the following:

  # agent_enabled: false

  # Logging level for log/newrelic_agent.log
  log_level: info

  application_logging:
    # If `true`, all logging-related features for the agent can be enabled or disabled
    # independently. If `false`, all logging-related features are disabled.
    enabled: true
    forwarding:
      # If `true`, the agent captures log records emitted by this application.
      enabled: true
      # Defines the maximum number of log records to buffer in memory at a time.
      max_samples_stored: 10000
    metrics:
      # If `true`, the agent captures metrics related to logging for this application.
      enabled: true
    local_decorating:
      # If `true`, the agent decorates logs with metadata to link to entities, hosts, traces, and spans.
      # This requires a log forwarder to send your log files to New Relic.
      # This should not be used when forwarding is enabled.
      enabled: false

# Environment-specific settings are in this section.
# RAILS_ENV or RACK_ENV (as appropriate) is used to determine the environment.
# If your application has other named environments, configure them here.
development:
  <<: *default_settings
  app_name: 'whataloaf (Development)'

test:
  <<: *default_settings
  # It doesn't make sense to report to New Relic from automated test runs.
  monitor_mode: false

staging:
  <<: *default_settings
  app_name: 'whataloaf (Staging)'

production:
  <<: *default_settings