← Back to Guides
Header image for guide: Send logs to Papertrail from Northflank
Profile image for Dan Ambrose

By Dan Ambrose

Published 18th October 2022

Send logs to Papertrail from Northflank

Papertrail bundles a live tail log viewer with easy to create log groups. This guide will show you how to integrate your Papertrail account with Northflank.

Create a log destination on Papertrail

You need to configure your Papertrail to receive logs from Northflank. All log events are sent to a log destination, which you can create in the Papertrail UI. Follow this link or find it through the settings dropdown.

We recommend you use a port destination for a better log viewing experience.

papertrail-create-log-destination.png

Make sure you allow all logs from unrecognised senders for now. You can tweak this later once you start receiving logs.

papertrail-log-destination.png

Create your Papertrail sink

Follow this link or navigate to the log sinks page in your team or user account settings and add a log sink.

Enter a recognisable name for the sink and select Papertrail as the sink type.

Select the appropriate authentication strategy based on your Papertrail log destination type. We recommend leaving the encoding on text for the best log viewing experience in Papertrail.

create-papertrail-sink.png

You can target specific projects to forward logs from, and only containers running in the selected projects will have their logs forwarded.

Now add the log sink, and your logs should start arriving in Papertrail!

View your logs

Before your log sink is created, Northflank tries to send a log line to your Papertrail setup to verify the credentials are correct.

In Papertrail click on the Events viewer at the top of the UI. If you’re using a port destination, logs should have the clickable labels for each event.

papertrail-log-view.png

Papertrail lets you create groups which filter logs by system.

Northflank sends logs to a port destination with labels that use the format project-name/type/object-name pod

create-papertrail-group.png

If you want to display all logs from services within your project, you can create a group by going to your Papertrail dashboard, then select create group in the top right.

Your query would be <project-name>/service*

Back in the event viewer on the bottom left, you can select your new group.

papertrail-log-group.png

Update your log sink

If you want to modify your sink after creation, navigate to the log sink list and click on the sink to view its details.

You can update the project targets and sink data as well as pause/resume the sink.

Have questions or feedback? Contact us. We also have dedicated support plans for business customers available.

Share this article with your network