On-Premise Overview

You can run Atatus in your own environment (on-premises, hybrid or BYOC) when you need full control over your observability data. This page covers the on-premise setup for Atatus agents. This solution is ideal for businesses with strict compliance, data sovereignty, or security requirements that restrict sending telemetry data to the cloud.

Why Use On-Premise?

  • 🔒 Data Privacy & Security: Keep all monitoring data within your private network.
  • 🏢 Compliance: Meet regulatory standards (e.g., GDPR, HIPAA, SOC 2).
  • 🚀 Performance: Reduce latency by hosting the observability backend closer to your services.
  • ⚙️ Custom Control: Fully control scaling, backups, and integrations.

How to Get On-Premise

To get access to the on-premise version of Atatus:
  1. Contact Support: Email success@atatus.com or reach out via the dashboard.
  2. Get Installation Package: You’ll receive a Docker-based deployment package.
  3. Install & Configure: Follow the installation guide provided.
  4. Replace Endpoint URLs in agents as shown below.

Agent Endpoint Configuration

To connect your services to the on-premise Atatus instance, you must update the Atatus agent configurations by replacing:
  • YOUR_ON_PREMISE_DOMAIN → your Atatus on-premise server URL
  • YOUR_APP_NAME → the name of your monitored app
  • YOUR_LICENSE_KEY → You’ll find your license key in the Atatus dashboard during onboarding.
Example:
  • https://atatus-observability.mycompany.com
  • payment-service
  • lic_apm_8deff58f1ca9a05b1ad30185

Infra Agent

File: /etc/atatus-infra-agent/atatus.yml
Example:

Python Agent

File: settings.py
Example:

Node.js Agent

Create an atatus.js file in your project root:
Start your application with the -r flag:
Example:
Alternative: Using Environment Variables

Ruby Agent

File: config/atatus.yml
Example:

PHP Agent

1. Find the config path:
2. Edit atatus.ini:
Example:

Java Agent

Example:

.NET Agent

Option 1: appsettings.json
Example:
Option 2: Environment variables
Example:

ASP .NET Agent

Option 1: Web.config
Example:

Go Agent

Example:

Docker Monitoring

Example:

Kubernetes Monitoring

File: atatus_values.yaml
Example:

Browser Agent

Example:

OpenTelemetry Collector

File: otelcol-config-extras.yml
Example:

Need Help?

If you’re unsure how to set this up or need assistance with deployment, contact Atatus Support.