Skip to main content

Introduction

Logstag is a database monitoring platform for teams that operate production databases. It collects operational metadata and database statistics through a lightweight agent, sends those measurements to the Logstag backend, and presents them through focused views for health, activity, queries, schema, alerts, and database inventory.

Logstag is designed for observability and operational review. It does not act as a database proxy, query builder, migration tool, backup system, or database administration console.

What Logstag Collects

The Logstag agent connects to configured database targets and collects engine-specific operational signals, including:

  • Instance and server status.
  • Active sessions, waits, locks, blocking, and connection activity.
  • Query performance statistics where the database engine exposes them.
  • Schema, index, object, permission, and configuration metadata.
  • Replication, availability, persistence, memory, and capacity signals where supported.

Logstag does not read or copy application table rows. Some metadata can still be sensitive, such as query text, object names, users, roles, permissions, and configuration values. Treat the agent configuration and Logstag access controls accordingly.

Core Components

Logstag Agent

The agent is a Rust service that runs in the customer environment. It uses configured database credentials to run monitoring queries, then sends metric payloads to Logstag.

Current agent capabilities include:

  • TOML-based configuration.
  • Multiple database targets per agent.
  • Configurable collection intervals.
  • Optional password and API key encryption in local configuration.
  • Linux, Windows, and Docker-oriented packaging paths.
  • Engine-specific collectors for PostgreSQL, Microsoft SQL Server, MongoDB, Redis, Valkey, and Oracle.

Logstag Backend

The backend receives agent payloads, stores time-series and relational metadata, evaluates alerts, and serves product APIs for the web application.

Current backend capabilities include:

  • Agent registration and metric ingestion.
  • Per-engine metric ingestion for PostgreSQL, Microsoft SQL Server, MongoDB, Redis, Valkey, and Oracle.
  • Template-based alerting backed by embedded YAML templates.
  • Health check report generation.
  • Multi-tenant organization, user, role, API key, billing, integration, audit log, and alert management APIs.

Logstag Web Application

The web application is the primary operator interface. The main product areas are:

  • Health Check
  • Database Explorer
  • Schema Explorer
  • Activity Explorer
  • Query Explorer
  • Alerts
  • Assets
  • Integrations
  • Audit Logs, available only to the Account Owner

Preview And Roadmap Surfaces

Logstag can show preview-mode product surfaces that demonstrate the broader product direction. These surfaces are useful for evaluation, but the documentation separates them from currently supported workflows.

SurfaceDocumentation statusDirection
OverviewComing soonA consolidated monitoring dashboard for instances, databases, connections, alerts, trends, and system health.
InsightsRoadmapHigher-level analytics for optimization opportunities, change impact, security posture, data inventory, and forecasting.
ReportsComing soonA monitoring reports area that will include Health Check output as Monitoring becomes the primary product entry point.
Integration catalogRoadmapA broader catalog beyond Jira Cloud, including APM, CI/CD, project management, source control, incident management, cloud monitoring, and observability tools.
UsersSupported where enabledOrganization member, role, and access management for administrative users.

Audit Logs are intentionally separate from regular operator workflows. They are available only to the Account Owner because they contain organization activity and access-review context.

When a page documents a preview-mode capability, it uses Coming soon or Roadmap language unless that capability is already available in the supported operational flow.

Supported Database Engines

Logstag currently has agent and backend support for:

EngineMonitoring focus
PostgreSQLActivity, query statistics, instance metrics, schema metadata, roles, replication, configuration, alerts, and health checks.
Microsoft SQL ServerSession activity, database activity, Query Store or DMV query statistics, performance counters, schema and index metadata, Availability Groups, security, alerts, and health checks.
MongoDBServer, database, collection, operation, connection pool, security, storage, replication, alerts, and health checks.
RedisServer, clients, memory, persistence, commands, CPU, slowlog, latency, configuration, security, replication, alerts, and health checks.
ValkeyRedis-compatible monitoring paths for server, clients, memory, persistence, commands, latency, configuration, security, replication, and alerts.
OracleSessions, wait events, locks, tablespace I/O, memory, SQL performance, ASH, Data Guard, backup, AQ, redo logs, profile settings, schema, index, alerts, and health checks.

MySQL is planned for future coverage and is not part of the current supported engine set.

Collection Intervals

The agent groups monitoring work into configurable intervals:

IntervalDefaultTypical use
High frequency10 secondsActive sessions, connection pressure, waits, critical runtime signals.
Medium frequency1 minuteQuery performance, replication, memory, persistence, command, or workload signals.
Low frequency10 minutesConfiguration, system, and less frequently changing operational signals.
Schema frequency240 minutesSchema and index metadata, where collection is heavier and changes less often.

The exact collectors assigned to each interval vary by database engine.

What Logstag Does Not Do

Logstag does not:

  • Modify application tables or database schema.
  • Read or copy application table rows.
  • Sit between applications and databases.
  • Replace backups, replication, or disaster recovery.
  • Rewrite queries or automatically apply database changes.
  • Remove the need for database permissions review.

Next Step

Start with Getting Started to understand the minimum setup path, then use Agent Configuration and the engine-specific setup pages for production configuration details.