On-Premise Setup for Atatus Agents

On-Premise Overview

Atatus offers an on-premise setup for organizations that require full control over their observability data. 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:

Contact Support: Email success@atatus.com or reach out via the dashboard.
Get Installation Package: You’ll receive a Docker-based deployment package.
Install & Configure: Follow the installation guide provided.
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

license_key: "YOUR_LICENSE_KEY"
notify_url: "YOUR_ON_PREMISE_DOMAIN/track/infra"
log_notify_url: "YOUR_ON_PREMISE_DOMAIN/track/logs"

Example:

license_key: lic_infra_c6548e64ab674b8e9b5046c82c1c7c88
notify_url: "https://atatus-observability.mycompany.com/track/infra"
log_notify_url: "https://atatus-observability.mycompany.com/track/logs"

Python Agent

File: settings.py

ATATUS = {
    'APP_NAME': "YOUR_APP_NAME",
    'LICENSE_KEY': "YOUR_LICENSE_KEY",
    'NOTIFY_HOST': "YOUR_ON_PREMISE_DOMAIN",
    'ANALYTICS_NOTIFY_HOST': "YOUR_ON_PREMISE_DOMAIN",
}

Example:

ATATUS = {
    'APP_NAME': 'payment_service',
    'LICENSE_KEY': 'lic_apm_1761339b345839ceb2534d19cd1263b8',
    'NOTIFY_HOST': "https://atatus-observability.mycompany.com",
    'ANALYTICS_NOTIFY_HOST': "https://atatus-observability.mycompany.com",
}

Node.js Agent

Create an atatus.js file in your project root:

// atatus.js - Atatus Agent Initialization
import atatus from 'atatus-nodejs';

// For TypeScript:
// import * as atatus from 'atatus-nodejs';

atatus.start({
    licenseKey: "YOUR_LICENSE_KEY",
    appName: "YOUR_APP_NAME",
    notifyHost: "https://YOUR_ON_PREMISE_DOMAIN"
});

export default atatus;

Start your application with the -r flag:

node -r ./atatus.js app.js

Example:

// atatus.js
import atatus from 'atatus-nodejs';

atatus.start({
    licenseKey: "lic_apm_1761339b345839ceb2534d19cd1263b8",
    appName: "notification_service",
    notifyHost: "https://atatus-observability.mycompany.com"   // add port (:8091) if needed
});

export default atatus;

node -r ./atatus.js app.js

Alternative: Using Environment Variables

// atatus.js
import atatus from 'atatus-nodejs';

atatus.start();

export default atatus;

export ATATUS_LICENSE_KEY="YOUR_LICENSE_KEY"
export ATATUS_APP_NAME="YOUR_APP_NAME"
export ATATUS_NOTIFY_HOST="https://atatus-observability.mycompany.com"     # add port (:8091) if needed

node -r ./atatus.js app.js

Ruby Agent

File: config/atatus.yml

license_key: "YOUR_LICENSE_KEY"
app_name: "YOUR_APP_NAME"
notify_host: "YOUR_ON_PREMISE_DOMAIN"
analytics_notify_host: "YOUR_ON_PREMISE_DOMAIN"

Example:

license_key: "lic_apm_1761339b345839ceb2534d19cd1263b8"
app_name: "ruby_handler"
notify_host: "https://atatus-observability.mycompany.com"
analytics_notify_host: "https://atatus-observability.mycompany.com"

PHP Agent

1. Find the config path:

php -i | grep atatus.ini

2. Edit atatus.ini:

atatus.license_key = "YOUR_LICENSE_KEY"
atatus.app_name = "YOUR_APP_NAME"
atatus.collector.notify_host = "YOUR_ON_PREMISE_DOMAIN"
atatus.collector.notify_ssl = true

Example:

atatus.license_key = "lic_apm_fbdf970af389421998c7977b5bbf793e"
atatus.app_name = "product_management"
atatus.collector.notify_host = "atatus-observability.mycompany.com"
atatus.collector.notify_ssl = true

Java Agent

java -javaagent:./atatus-java-agent.jar \
  -Datatus.license_key="YOUR_LICENSE_KEY" \
  -Datatus.app_name="YOUR_APP_NAME" \
  -Datatus.notify_host="YOUR_ON_PREMISE_DOMAIN" \
  -jar your-app.jar

Example:

java -javaagent:./atatus-java-agent.jar \
  -Datatus.license_key="lic_apm_1761339b345839ceb2534d19cd1263b8" \
  -Datatus.app_name="shipping_service" \
  -Datatus.notify_host="https://atatus-observability.mycompany.com" \
  -jar target/spring-boot-mongodb-0.0.1-SNAPSHOT.jar

.NET Agent

Option 1: appsettings.json

"Atatus": {
    "AppName": "YOUR_APP_NAME",
    "LicenseKey": "YOUR_LICENSE_KEY",
    "NotifyUrls": "YOUR_ON_PREMISE_DOMAIN"
}

Example:

"Atatus": {
    "AppName": "inventory_service",
    "LicenseKey": "lic_apm_1761339b345839ceb2534d19cd1263b8",
    "NotifyUrls": "https://atatus-observability.mycompany.com"
}

Option 2: Environment variables

export ATATUS_LICENSE_KEY="YOUR_LICENSE_KEY"
export ATATUS_APP_NAME="YOUR_APP_NAME"
export ATATUS_SERVER_URL="YOUR_ON_PREMISE_DOMAIN"

Example:

export ATATUS_LICENSE_KEY="lic_apm_1761339b345839ceb2534d19cd1263b8"
export ATATUS_APP_NAME="inventory_service"
export ATATUS_SERVER_URL="https://atatus-observability.mycompany.com"

ASP .NET Agent

Option 1: Web.config

<?xml version="1.0" encoding="utf-8"?>

<configuration>

    <appSettings>
        <add key="Atatus:AppName" value="YOUR_APP_NAME" />
        <add key="Atatus:LicenseKey" value="YOUR_LICENSE_KEY" />
        <add key="Atatus:NotifyUrls" value="YOUR_ON_PREMISE_DOMAIN"/>
    </appSettings>

</configuration>

Example:

<appSettings>
    <add key="Atatus:AppName" value="inventory_service" />
    <add key="Atatus:LicenseKey" value="lic_apm_1761339b345839ceb2534d19cd1263b8" />
    <add key="Atatus:NotifyUrls" value="https://atatus-observability.mycompany.com"/>
</appSettings>

Go Agent

env ATATUS_LICENSE_KEY="YOUR_LICENSE_KEY" \
    ATATUS_APP_NAME="YOUR_APP_NAME" \
    ATATUS_NOTIFY_HOST="YOUR_ON_PREMISE_DOMAIN" \
    go run main.go

Example:

env ATATUS_LICENSE_KEY='lic_apm_1761339b345839ceb2534d19cd1263b8' \
    ATATUS_APP_NAME="orders_service" \
    ATATUS_NOTIFY_HOST="https://atatus-observability.mycompany.com" \
    go run main.go

Docker Monitoring

sudo docker run -d \
  -e ATATUS_LICENSE_KEY="YOUR_LICENSE_KEY" \
  -e ATATUS_NOTIFY_HOST="YOUR_ON_PREMISE_DOMAIN/track/infra" \
  -e ATATUS_LOG_NOTIFY_HOST="YOUR_ON_PREMISE_DOMAIN/track/logs" \
  --user=root \
  --volume="/var/lib/docker/containers:/var/lib/docker/containers:ro" \
  --volume="/var/run/docker.sock:/var/run/docker.sock:ro" \
  --volume="/sys/fs/cgroup:/hostfs/sys/fs/cgroup:ro" \
  --volume="/proc:/hostfs/proc:ro" \
  --volume="/:/hostfs:ro" \
  -it atatus/atatus-infra-agent:4.1.0 -- -c /etc/atatus-infra-agent/ --system.hostfs=/hostfs

Example:

sudo docker run -d \
  -e ATATUS_LICENSE_KEY='lic_infra_c6548e64ab674b8e9b5046c82c1c7c88' \
  -e ATATUS_NOTIFY_HOST="https://atatus-observability.mycompany.com/track/infra" \
  -e ATATUS_LOG_NOTIFY_HOST="https://atatus-observability.mycompany.com/track/logs" \
  --user=root \
  --volume="/var/lib/docker/containers:/var/lib/docker/containers:ro" \
  --volume="/var/run/docker.sock:/var/run/docker.sock:ro" \
  --volume="/sys/fs/cgroup:/hostfs/sys/fs/cgroup:ro" \
  --volume="/proc:/hostfs/proc:ro" \
  --volume="/:/hostfs:ro" \
  -it atatus/atatus-infra-agent:4.1.0 -- -c /etc/atatus-infra-agent/ --system.hostfs=/hostfs

Kubernetes Monitoring

File: atatus_values.yaml

atatus:
  license_key: "YOUR_LICENSE_KEY"
  notify_url: "YOUR_ON_PREMISE_DOMAIN/track/infra"
  log_notify_url: "YOUR_ON_PREMISE_DOMAIN/track/logs"
  logs_enabled: true
  cluster_name: "YOUR_CLUSTER_NAME"

Example:

atatus:
  license_key: "lic_infra_c6548e64ab674b8e9b5046c82c1c7c88"
  notify_url: "https://atatus-observability.mycompany.com/track/infra"
  log_notify_url: "https://atatus-observability.mycompany.com/track/logs"
  logs_enabled: true
  cluster_name: "prod-cluster"

Browser Agent

import * as atatus from 'atatus-js';

atatus.config('YOUR_LICENSE_KEY').install();
atatus.setAPIEndpoint('YOUR_ON_PREMISE_DOMAIN');

Example:

import * as atatus from 'atatus-js';

atatus.config('lic_apm_1761339b345839ceb2534d19cd1263b8').install();
atatus.setAPIEndpoint('https://atatus-observability.mycompany.com');

OpenTelemetry Collector

File: otelcol-config-extras.yml

exporters:
  otlphttp/alpha:
    endpoint: "YOUR_ON_PREMISE_DOMAIN"
    headers:
      api-key: "YOUR_API_KEY"
      compression: gzip

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/alpha]
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/alpha]
    logs:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/alpha]

Example:

exporters:
  otlphttp/alpha:
    endpoint: 'https://atatus-observability.mycompany.com'
    headers:
      api-key: 'ak_3e70b36d53d246889f7ed7645ff85193'
      compression: gzip

service:
  pipelines:
    traces:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/alpha]
    metrics:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/alpha]
    logs:
      receivers: [otlp]
      processors: [batch]
      exporters: [otlphttp/alpha]

Need Help?

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

​On-Premise Overview

​Why Use On-Premise?

​How to Get On-Premise

​Agent Endpoint Configuration

​Infra Agent

​Python Agent

​Node.js Agent

​Ruby Agent

​PHP Agent

​Java Agent

​.NET Agent

​ASP .NET Agent

​Go Agent

​Docker Monitoring

​Kubernetes Monitoring

​Browser Agent

​OpenTelemetry Collector

​Need Help?

On-Premise Overview

Why Use On-Premise?

How to Get On-Premise

Agent Endpoint Configuration

Infra Agent

Python Agent

Node.js Agent

Ruby Agent

PHP Agent

Java Agent

.NET Agent

ASP .NET Agent

Go Agent

Docker Monitoring

Kubernetes Monitoring

Browser Agent

OpenTelemetry Collector

Need Help?