Log Streams

You can stream the logs generated by your Render services to any logging provider with a TLS-enabled syslog endpoint, such as Datadog or Sumo Logic. This includes HTTP request logs for Professional workspaces and higher.

After you set a default stream destination for your workspace, all of your supported services start streaming their logs to that destination. You can override this for individual services.

Setup

1. In the Render Dashboard, go to your Workspace Settings page and scroll down to the Log Streams section:

   

2. Under Default destination, click + Set default.

   The following dialog appears:

   

3. Provide your syslog endpoint URL in the Log Endpoint field.

   • Use the format HOST:PORT (for example, logs.papertrailapp.com:34302).
   • For help finding the endpoint URL with common providers, see below.

4. If Render needs to include an authentication token with all reported logs, provide it in the Token field.

   • This is required for logging providers that use a single syslog endpoint for multiple users, such as Datadog.

5. Click Save Changes.

6. Toggle Include logs from preview instances to configure whether your log stream includes logs from your service previews and preview environments.

You’re all set! Logs from Render will start to appear in your provider’s feed shortly.

Overriding defaults

Professional workspaces and higher can override their default log stream settings for individual services:

1. In the Render Dashboard, open the Settings page for the service you want to override and scroll down to the Log Stream section:

   

2. Click Override. The following dialog appears:

   

3. Select Forward to a different destination or Don’t forward this service’s logs.

   • Forwarding to a different destination requires an Organization workspace or higher.

4. Provide any necessary details for the selected option and click Save override.

You’re all set! Your service now uses its own custom log stream settings:

You can revert this custom configuration by clicking Reset to default.

Reporting format

Render streams logs to your provider’s syslog endpoint over TCP. Log lines are formatted according to RFC5424, which is supported by most popular providers.

Log streams do not support:

• Insecure (non-TLS-enabled) endpoints
• Providers that require a custom log format

A formatted log line looks like this:

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

Render annotates each log line with:

• The corresponding service’s slug
• The type of service (web, cron, etc.)
• A unique identifier for the instance
  • Use this value to track your service between deploys, or to distinguish between multiple instances if you’re running more than one.

If you’re using a standard format like logfmt or json, Render maps the level field to an appropriate syslog priority. Otherwise, Render makes a best effort to parse log levels, defaulting to INFO.

Finding your syslog endpoint

Consult your logging provider’s documentation to obtain your syslog endpoint and any necessary token. Instructions for certain providers are also available below.

Better Stack (previously Logtail)

Create a new source in Better Stack Logs with the platform Render:

Then, when adding your log stream in Render:

• Provide in.logs.betterstack.com:6514 as the Log Endpoint.
• Provide the source token from Better Stack as the Token.

For more information, see the Better Stack documentation.

Datadog

See this section.

highlight.io

To stream logs to your existing highlight.io project:

• Provide syslog.highlight.io:34302 as the Log Endpoint.
• Provide your highlight project ID as the Token.
  • Your highlight project ID is shown in the top left of your project page.

For more information, see the highlight.io documentation.

Mezmo (previously LogDNA)

Log in to your Mezmo account and navigate to the sources page. Select syslog on the left sidebar to see your syslog endpoint.

Papertrail

Log in to your account and navigate to the setup page to find your Syslog endpoint:

If you use the same Papertrail account to collect logs from multiple providers, you can optionally generate a unique endpoint for your Render services.

SolarWinds

Follow the instructions for sending logs using syslog.

• Set the Log Endpoint to your organization’s syslog collector endpoint. This endpoint has the format syslog.collector.xx-yy.cloud.solarwinds.com, where xx-yy represents the data center your organization uses. See Data centers and endpoint URIs to find the exact URL.
• Provide your API ingestion token as the Token.
  • Your API ingestion token is found in the Token field.

Sumo Logic

Follow the instructions for configuring a cloud syslog source.

After you configure your source, Sumo Logic displays a modal with a Token and Host. Use these for your log stream’s Token and Log Endpoint, respectively.