Getting started with Uptrace

Getting started with Uptrace is easy:

  1. To host Uptrace yourself, download and install Uptrace binary. Or createopen in new window a free cloud account and let us manage Uptrace for you.

  2. To start receiving data, use the DSN (connection string) you've obtained on the previous step to configure Uptrace distro for your programming language.

  1. Instrumentopen in new window your application with plugins for popular frameworks and libraries.

  2. Install OpenTelemetry Collector to monitor host metrics, Redis, PostgreSQL, MySQL and many more.

  3. You can also use Vector to collect logs from a file or syslog.

Have questions? Get help via Telegramopen in new window or start a discussionopen in new window on GitHub.


Uptrace DSN is a connection string that contains connections details for an Uptrace backend, and a secret token that grants write access to a project.

For example, the DSN http://project1_secret_token@localhost:14317/1 contains the following information:

  • http - tells the client to disable TLS. Use https to enable it.
  • localhost:14317 - an address of the Uptrace backend. The cloud version always uses the address without a port.
  • project1_secret_token - a secret token that is used for authentication in the backend.
  • /1 - a project id.

You can always find your project DSN on the project settings page or by clicking on the Help icon:

Uptrace DSN

Last Updated: