Zharp Agent Setup
The Zharp Agent is a lightweight binary that acts as a secure bridge between your private infrastructure and the Zharp Cloud.
Required for monitoring databases (Postgres, MySQL, Redis, MongoDB) that are not exposed to the public internet, or for high-precision infrastructure telemetry.
1. Installation
Run the one-line installer on your Linux or Windows server. This will install the binary and create the service.
export ZHARP_TOKEN="YOUR_WORKSPACE_TOKEN" && curl -sSL https://get.zharp.io/install.sh | bash2. Configure zharp.yaml
Add your database or log sources to the configuration file. For Postgres, use the postgresql source type.
# Zharp Agent Configuration
# https://docs.zharp.io/agent
api_key: "YOUR_API_TOKEN" # Manage tokens in Developer Settings
sources:
my_postgres_db:
type: postgresql
endpoints:
- "postgresql://user:password@localhost:5432/database"
my_mysql_db:
type: mysql
endpoints:
- "mysql://user:password@localhost:3306/database"
sinks:
zharp:
type: zharp_platform
inputs:
- my_postgres_db
- my_mysql_db
agent_id: "YOUR_AGENT_ID"
service_id: "multiple" # For multiple services, the agent uses source names as individual service IDsThe source name (e.g., my_postgres_db) in your config MUST match the Database Name you enter in the Zharp Dashboard to link the telemetry correctly.
3. Verify Connection
Restart your agent and check the Integrations tab in your Zharp Dashboard. You should see your agent appear as "Connected".
Database Monitoring
Once the agent is running, go to Monitors > Create New > Postgres or MySQL. Select Internal Mode, choose your agent from the list, and enter the Database Name (source name) defined in your config.
Fleet Management
View and manage all your deployed agents across different environments in one place.
View Agent Fleetarrow_forward