Log Streams


Render Log Streams forward logs from your web services, private services, background workers, databases, and cron jobs to any logging provider that supplies a TLS-enabled syslog drain.

Service logs are delivered to the provider’s syslog endpoint via TCP, and are formatted according to RFC5424, the specification most commonly used by providers. A formatted log line would look like:

<0>1 2021-03-31T16:00:00-08:00 test-service cron-12345 74440 cron-12345 - hello this is a test

Your provider will parse the relevant details from the formatted log line. Render annotates your logs with your service slug, the type of service, and a unique identifier for the instance (you can use this to track your service between deploys, or to distinguish between multiple instances if you are running more than one).

Configuring Log Streams

To define a Log Streams endpoint, navigate to Account or Team Settings in your Render dashboard. Locate the Log Streams section, click “Add Log Stream”, and enter your endpoint URL in the format HOST:PORT, for example logs.papertrailapp.com:34302.

Some logging providers like Datadog require an authentication token with every log line sent to a syslog endpoint. This helps them differentiate your logs from other accounts using a shared syslog URL.

You can add a token to your Log Stream during setup and Render will automatically handle logging authentication for you.

Log Streams can be configured for an account or a team, and apply to all supported services owned by the account or team. If you manage multiple teams on Render, please configure a log endpoint for each team separately.

Render Log Stream Settings

Supported Providers

Render can forward your logs to any TLS-enabled syslog endpoint that expects logs formatted per RFC5424. We do not support insecure (non TLS-enabled) endpoints or providers that require a custom log format. Most steps listed by logging providers to set up syslog (such as updating a configuration file, restarting services, etc.) are not needed with Log Streams; you simply need to obtain your syslog endpoint and enter it in the Render dashboard.

If you’re running into issues with Log Streams and you believe your logging provider should be supported, please let us know at support@render.com.

Where to Find Your Syslog Endpoint

Papertrail

Once you’ve logged into your account, navigate to the setup page to obtain your Syslog endpoint:

Papertrail Syslog Settings

You can also optionally generate a unique endpoint for your Render services if you use the same Papertrail account for logs from services hosted on other providers.

Logtail

Create a new source in Logtail with the platform “Render”:

Logtail source settings

Enter the “Source Token” from Logtail as the Token in your Render Log Stream settings and the URL in.logtail.com:6514 for the Endpoint.

Datadog

Create or retrieve an API key from your Datadog settings:

Datadog API settings

Enter the API key in the Token field and the URL intake.logs.datadoghq.com:10516 for the Endpoint.

LogDNA

We have observed high rates of connection failures with LogDNA's syslog endpoint and do not recommend using them at this time.

Log into your account and navigate to the sources page. Select “syslog” on the left sidebar to see your syslog endpoint.

LogDNA Syslog Settings