Use our Vector output sink to connect your Vector-monitored log data to New Relic. Read on to learn how to configure and test the Vector New Relic logs sink.
To forward your logs to New Relic using Vector, you'll need:
- A New Relic license key
- Vector version 0.7.0 or higher
To configure the Vector New Relic logs sink:
Add a snippet to your
vector.tomlfile (located in
/etc/vectorby default), replacing YOUR_LICENSE_KEY with the New Relic license key:
# Ingest data by tailing one or more files [sources.mylog] type = "file" include = ["/path/to/file"] # Specify file or files to be tailed ignore_older = 86400 # Ignore events older than 1 day file_key = "file" # Add filename to log events host_key = "host" # Add hostname to log events # Configure sink to forward events to New Relic Logs [sinks.new_relic_logs] # REQUIRED type = "new_relic_logs" # must be: "new_relic_logs" inputs = ["mylog"] # example - value must be one or more source IDs license_key = "YOUR_LICENSE_KEY" region = "us" # Enum, must be one of: "us" "eu" depending on your New Relic Logs account region encoding.codec = "json" # OPTIONAL healthcheck = true # default
Restart the Vector service to ensure your changes are applied.
To test if the New Relic logs sink is forwarding events:
Run the following command to append a test log message to your log file:
echo "test message" >> /PATH/TO/YOUR/LOG/FILE
Search New Relic Logs UI for your test message.
If everything is configured correctly and your data is being collected, you should see data logs in both of these places:
- New Relic Logs UI
- New Relic tools for running NRQL queries. For example, you can execute a query like this:
SELECT * FROM Log
Now that you've enabled Logs, here are some potential next steps:
- Explore your data using the Logs UI.
- Configure your agent to see contextual log data, such as distributed tracing, stack traces, application logs, and more.
- Query your data and create custom dashboards or alerts.
If no data appears after you enable New Relic Logs, follow the troubleshooting procedures.