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).
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
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 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 email@example.com.
Once you’ve logged into your account, navigate to the setup page to obtain your Syslog endpoint:
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.
Create a new source in Logtail with the platform “Render”:
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.
Create or retrieve an API key from your Datadog settings:
Enter the API key in the Token field and use the endpoint that corresponds to your Datadog site:
Log into your account and navigate to the sources page. Select “syslog” on the left sidebar to see your syslog endpoint.