• Log inStart now

Set up network syslog monitoring

Set up your network devices so they send syslog data to New Relic.

Add network syslog data

Prerequisites

New Relic prerequisites

Linux host prerequisites

  • Docker installed in a Linux host.
  • SSH access to the Docker host, with the ability to launch new containers.

Network syslog devices prerequisites

Network security prerequisites

Direction

Source

Destination

Ports

Protocol

Outbound

Docker host

ktranslate image on Docker Hub or Quay.io

443

TCP

Outbound

Docker host

New Relic Log API endpoint:

  • US Endpoint:
    https://log-api.newrelic.com
  • EU Endpoint:
    https://log-api.eu.newrelic.com

443

TCP

Inbound

Source devices for syslog data

Docker host

5143 (default)

UDP

Tip

The default listening port for ktranslate is 5143 (TCP/UDP). If you need to use the default syslog port of 514, you can do so by removing --net=host from your run command, replacing it with -p 514:5143/udp. To bind the listener to a port above 1024, add -syslog.source="0.0.0.0:<port>" to the end of the run command instead.

Set up network syslog monitoring in New Relic

  1. Go to one.newrelic.com and click Add more data.
  2. Scroll down until you see Network monitoring and click Syslog.
  3. Follow the steps in New Relic.

Here's a short video (2:56 minutes) showing how to set up network syslog monitoring:

If you prefer to do the setup manually, see the instructions below.

Tip

ktranslate handles syslog in the following formats: RFC3164, RFC5424, and RFC6587.

Investigate your device syslog messages in the New Relic logs UI, using the following query:

"plugin.type":"ktranslate-syslog"

To get better visibility into your network device performance, set up SNMP data monitoring.

To get better visibility into how your network is being used, set up network flow data monitoring.

Copyright © 2022 New Relic Inc.