# Bleemeo Documentation

> Technical documentation for Bleemeo, the cloud monitoring platform that deploys in minutes and scales without surprises. One lightweight agent auto-discovers your entire infrastructure and starts collecting metrics, logs, and uptime checks instantly. For company information, product details, and pricing, see [bleemeo.com](https://bleemeo.com) and its [llms.txt](https://bleemeo.com/llms.txt).

This documentation covers agent installation and configuration, server and service monitoring, Kubernetes and cloud monitoring, alerting and notifications, dashboards, API reference, and administration of the Bleemeo platform.

## Getting Started

- [Getting Started](https://docs.bleemeo.com/getting-started/): Install the Bleemeo monitoring agent and start monitoring your infrastructure in 30 seconds with automatic service discovery
- [Monitoring Key Concepts](https://docs.bleemeo.com/monitoring-key-concepts/): Fundamental concepts and terminology - agents, metrics, services, dashboards, alerts, and monitors
- [FAQ](https://docs.bleemeo.com/faq/): Frequently asked questions about Bleemeo Cloud Monitoring

## Agent

- [Bleemeo Agent](https://docs.bleemeo.com/agent/): Overview of the lightweight monitoring agent that collects metrics and sends them to Bleemeo Cloud
- [Agent Installation](https://docs.bleemeo.com/agent/installation/): Install on Windows and Linux using native packages, Docker, or Kubernetes
- [Configuration](https://docs.bleemeo.com/agent/configuration/): Configure with environment variables or custom configuration files
- [Agent Facts](https://docs.bleemeo.com/agent/agent-fact/): Retrieve facts for servers and devices to identify your equipment
- [Metrics Filtering](https://docs.bleemeo.com/agent/filtering/): Filter metrics sent to the Cloud platform to limit resource usage and allow privacy filtering
- [Migrate Agent](https://docs.bleemeo.com/agent/migrate/): Migrate the agent to a new server while keeping data history and configurations
- [Troubleshoot](https://docs.bleemeo.com/agent/troubleshoot/): Debug agent connection issues using logs and diagnostic pages
- [Uninstall](https://docs.bleemeo.com/agent/uninstall/): Remove the agent using native packages or Docker

## Server Monitoring

- [Server Monitoring Overview](https://docs.bleemeo.com/server-monitoring/): Monitor servers with OS metrics, services, processes, and GPU monitoring
- [Operating System Metrics](https://docs.bleemeo.com/server-monitoring/operating-system/): CPU, memory, disk usage, and other host OS metrics
- [Docker Monitoring](https://docs.bleemeo.com/server-monitoring/docker/): Monitor Docker container metrics with automatic dashboards
- [NVIDIA GPU Monitoring](https://docs.bleemeo.com/server-monitoring/nvidia/): Monitor GPU and memory usage via NVIDIA drivers
- [Key Process Metrics](https://docs.bleemeo.com/server-monitoring/key-process/): Monitor CPU and memory usage of specific processes
- [Services Monitoring Overview](https://docs.bleemeo.com/server-monitoring/services/): Auto-detect 100+ services with health checks and metrics

### Monitored Services

- [Apache HTTP](https://docs.bleemeo.com/server-monitoring/services/apache-http/): Apache web server monitoring
- [Asterisk](https://docs.bleemeo.com/server-monitoring/services/asterisk/): Asterisk PBX monitoring
- [BIND](https://docs.bleemeo.com/server-monitoring/services/bind/): BIND DNS server monitoring
- [Bitbucket](https://docs.bleemeo.com/server-monitoring/services/bitbucket/): Atlassian Bitbucket monitoring
- [Cassandra](https://docs.bleemeo.com/server-monitoring/services/cassandra/): Apache Cassandra monitoring
- [Confluence](https://docs.bleemeo.com/server-monitoring/services/confluence/): Atlassian Confluence monitoring
- [Dovecot](https://docs.bleemeo.com/server-monitoring/services/dovecot/): Dovecot IMAP server monitoring
- [Ejabberd](https://docs.bleemeo.com/server-monitoring/services/ejabberd/): Ejabberd XMPP server monitoring
- [Elasticsearch](https://docs.bleemeo.com/server-monitoring/services/elasticsearch/): Elasticsearch monitoring
- [Exim4](https://docs.bleemeo.com/server-monitoring/services/exim4/): Exim mail server monitoring
- [Fail2Ban](https://docs.bleemeo.com/server-monitoring/services/fail2ban/): Fail2Ban intrusion prevention monitoring
- [FreeRADIUS](https://docs.bleemeo.com/server-monitoring/services/freeradius/): FreeRADIUS server monitoring
- [HAProxy](https://docs.bleemeo.com/server-monitoring/services/haproxy/): HAProxy load balancer monitoring
- [InfluxDB](https://docs.bleemeo.com/server-monitoring/services/influxdb/): InfluxDB time series database monitoring
- [Jenkins](https://docs.bleemeo.com/server-monitoring/services/jenkins/): Jenkins CI/CD monitoring
- [Jira](https://docs.bleemeo.com/server-monitoring/services/jira/): Atlassian Jira monitoring
- [Kafka](https://docs.bleemeo.com/server-monitoring/services/kafka/): Apache Kafka monitoring
- [Libvirtd](https://docs.bleemeo.com/server-monitoring/services/libvirtd/): Libvirt virtualization monitoring
- [Memcached](https://docs.bleemeo.com/server-monitoring/services/memcached/): Memcached monitoring
- [MongoDB](https://docs.bleemeo.com/server-monitoring/services/mongodb/): MongoDB monitoring
- [Mosquito](https://docs.bleemeo.com/server-monitoring/services/mosquito/): Eclipse Mosquito MQTT broker monitoring
- [MySQL](https://docs.bleemeo.com/server-monitoring/services/mysql/): MySQL database monitoring
- [NATS](https://docs.bleemeo.com/server-monitoring/services/nats/): NATS messaging server monitoring
- [NFS](https://docs.bleemeo.com/server-monitoring/services/nfs/): NFS file server monitoring
- [Nginx](https://docs.bleemeo.com/server-monitoring/services/nginx/): Nginx web server monitoring
- [NTP](https://docs.bleemeo.com/server-monitoring/services/ntp/): NTP time server monitoring
- [OpenLDAP](https://docs.bleemeo.com/server-monitoring/services/openldap/): OpenLDAP directory monitoring
- [OpenVPN](https://docs.bleemeo.com/server-monitoring/services/openvpn/): OpenVPN server monitoring
- [PHP-FPM](https://docs.bleemeo.com/server-monitoring/services/php-fpm/): PHP-FPM monitoring
- [PostgreSQL](https://docs.bleemeo.com/server-monitoring/services/postgresql/): PostgreSQL database monitoring
- [Postfix](https://docs.bleemeo.com/server-monitoring/services/postfix/): Postfix mail server monitoring
- [RabbitMQ](https://docs.bleemeo.com/server-monitoring/services/rabbitmq/): RabbitMQ message broker monitoring
- [Redis](https://docs.bleemeo.com/server-monitoring/services/redis/): Redis monitoring
- [Salt](https://docs.bleemeo.com/server-monitoring/services/salt/): SaltStack monitoring
- [Squid](https://docs.bleemeo.com/server-monitoring/services/squid3/): Squid proxy server monitoring
- [UPS (upsd)](https://docs.bleemeo.com/server-monitoring/services/upsd/): UPS monitoring via NUT
- [uWSGI](https://docs.bleemeo.com/server-monitoring/services/uwsgi/): uWSGI application server monitoring
- [Valkey](https://docs.bleemeo.com/server-monitoring/services/valkey/): Valkey (Redis fork) monitoring
- [Varnish](https://docs.bleemeo.com/server-monitoring/services/varnish/): Varnish cache monitoring
- [ZooKeeper](https://docs.bleemeo.com/server-monitoring/services/zookeeper/): Apache ZooKeeper monitoring

## Uptime Monitoring

- [Configuration](https://docs.bleemeo.com/uptime-monitoring/configuration/): Monitor availability of public and private services using HTTP, HTTPS, ICMP, and TCP checks
- [SSL & Domain Expiration](https://docs.bleemeo.com/uptime-monitoring/ssl-domain-expiration/): Monitor SSL certificate and domain expiration dates
- [Reports](https://docs.bleemeo.com/uptime-monitoring/report/): Generate daily and monthly availability and response time reports

## Application Monitoring

- [Application Monitoring Overview](https://docs.bleemeo.com/application-monitoring/): Group services into applications and view unified health
- [Custom Metrics](https://docs.bleemeo.com/application-monitoring/custom/): Define and send custom metrics from HTTP endpoints or files
- [Prometheus Monitoring](https://docs.bleemeo.com/application-monitoring/prometheus/): Ingest metrics from any Prometheus exporter
- [Go Instrumentation](https://docs.bleemeo.com/application-monitoring/go/): Instrument Go applications with the Prometheus client library
- [Java Instrumentation](https://docs.bleemeo.com/application-monitoring/java/): Instrument Java applications with the Prometheus client library
- [Python Instrumentation](https://docs.bleemeo.com/application-monitoring/python/): Instrument Python applications with the Prometheus client library
- [Ruby Instrumentation](https://docs.bleemeo.com/application-monitoring/ruby/): Instrument Ruby applications with the Prometheus client library
- [Rust Instrumentation](https://docs.bleemeo.com/application-monitoring/rust/): Instrument Rust applications with the Prometheus client library
- [StatsD](https://docs.bleemeo.com/application-monitoring/statsd/): Push application metrics using the StatsD protocol
- [Java JMX Monitoring](https://docs.bleemeo.com/application-monitoring/java-jmx/): Retrieve JMX metrics from Java processes
- [Public Status Page](https://docs.bleemeo.com/application-monitoring/public-status-page/): Share application uptime and incidents with your customers

## Kubernetes Monitoring

- [Overview](https://docs.bleemeo.com/kubernetes-monitoring/): Automatic service discovery, pod metrics, and cluster health monitoring
- [Installation](https://docs.bleemeo.com/kubernetes-monitoring/installation/): Deploy with Helm chart for Kubernetes health monitoring
- [Kubernetes Metrics](https://docs.bleemeo.com/kubernetes-monitoring/metrics/): Pod requests, limits, and deployment metrics
- [Upgrade](https://docs.bleemeo.com/kubernetes-monitoring/upgrade/): Upgrade the agent in Kubernetes clusters

## AWS Monitoring

- [AWS Monitoring Overview](https://docs.bleemeo.com/aws-monitoring/): Monitor AWS resources using CloudWatch integration

## Network Monitoring

- [Overview](https://docs.bleemeo.com/network-monitoring/): Monitor SNMP devices using standard MIBs
- [SNMP Metrics](https://docs.bleemeo.com/network-monitoring/metrics-snmp/): Available SNMP metrics and automatic dashboard creation

## VMware Monitoring

- [VMware vSphere Overview](https://docs.bleemeo.com/vmware-monitoring/): Monitor vSphere clusters, hosts, and VMs for CPU, memory, and disk metrics

## Dashboards

- [Dashboard Overview](https://docs.bleemeo.com/dashboard/): Real-time visibility into infrastructure health and performance
- [Agent Dashboard](https://docs.bleemeo.com/dashboard/agent-dashboards/): Automatically created dashboards for connected servers
- [Custom Dashboards](https://docs.bleemeo.com/dashboard/custom-dashboards/): Create dashboards with multiple widget types and any available metrics
- [Dashboard Templates](https://docs.bleemeo.com/dashboard/dashboards-template/): Customize default dashboards or create templates for server groups
- [Health Checks Dashboards](https://docs.bleemeo.com/dashboard/healthcheck-dashboards/): View current infrastructure issues at a glance
- [Monitor Dashboards](https://docs.bleemeo.com/dashboard/monitor-dashboards/): Response time and availability dashboards for monitored services
- [Status Dashboards](https://docs.bleemeo.com/dashboard/status-dashboards/): Infrastructure status overview
- [Annotations](https://docs.bleemeo.com/dashboard/annotations/): Mark deployments, incidents, or maintenance on dashboard graphs

## Alerting

- [Alerting Overview](https://docs.bleemeo.com/alerting/): Configure alerts and notifications with thresholds and rules
- [Events](https://docs.bleemeo.com/alerting/events/): Incident events are created and stored for history
- [Notifications](https://docs.bleemeo.com/alerting/notifications/): Configure alerting rules to send notifications on incidents
- [Notification Targets](https://docs.bleemeo.com/alerting/notification-targets/): Define where notifications are sent
- [Contacts Groups](https://docs.bleemeo.com/alerting/contacts-groups/): Group contacts for notification routing
- [Server Groups](https://docs.bleemeo.com/alerting/server-groups/): Define alerting thresholds for multiple servers
- [On-Call](https://docs.bleemeo.com/alerting/on-call/): Configure on-call schedules for alert routing
- [Recording Rules](https://docs.bleemeo.com/alerting/recording-rule/): Define recording rules for alerting thresholds
- [Silences](https://docs.bleemeo.com/alerting/silence/): Pause notifications during maintenance with single, recurring, or automatic silences

### Alerting Integrations

- [Slack](https://docs.bleemeo.com/alerting/integrations/slack/): Send alerts to Slack channels with rich formatting
- [PagerDuty](https://docs.bleemeo.com/alerting/integrations/pagerduty/): Create incidents and trigger on-call rotations
- [OpsGenie](https://docs.bleemeo.com/alerting/integrations/opsgenie/): Route alerts to on-call teams with escalation policies
- [Microsoft Teams Workflows](https://docs.bleemeo.com/alerting/integrations/microsoft-teams-workflows/): Send alerts via Power Automate workflows
- [Discord](https://docs.bleemeo.com/alerting/integrations/discord/): Send alerts to Discord channels using webhooks
- [Telegram](https://docs.bleemeo.com/alerting/integrations/telegram/): Receive alerts via Telegram bot messages
- [Email](https://docs.bleemeo.com/alerting/integrations/email/): Receive alerts via email
- [Webhook](https://docs.bleemeo.com/alerting/integrations/webhook/): Send alerts to any HTTP endpoint
- [Atlassian Jira](https://docs.bleemeo.com/alerting/integrations/jira/): Automatically create Jira issues from alerts
- [GitHub Issues](https://docs.bleemeo.com/alerting/integrations/github/): Automatically create GitHub issues from alerts
- [GitLab Issues](https://docs.bleemeo.com/alerting/integrations/gitlab/): Automatically create GitLab issues from alerts
- [Rocket.Chat](https://docs.bleemeo.com/alerting/integrations/rocketchat/): Send alerts to Rocket.Chat via webhooks
- [VictorOps (Splunk On-Call)](https://docs.bleemeo.com/alerting/integrations/victorops/): Incident management and on-call alerting
- [Twilio SMS](https://docs.bleemeo.com/alerting/integrations/twilio/): Send alerts via SMS using Twilio
- [OVH SMS](https://docs.bleemeo.com/alerting/integrations/ovh/): Send alerts via SMS using OVH Telecom
- [MessageBird SMS](https://docs.bleemeo.com/alerting/integrations/messagebird/): Send alerts via SMS using MessageBird
- [Mobile Application](https://docs.bleemeo.com/alerting/integrations/mobile-app/): Push notifications on iOS and Android

## Logs

- [Logs Overview](https://docs.bleemeo.com/logs/): Monitor application logs with OpenTelemetry-based collection from files, containers, and OTLP receivers
- [File Logs](https://docs.bleemeo.com/logs/file-logs/): Collect and process log files with glob patterns, operators, and filters
- [Container Logs](https://docs.bleemeo.com/logs/container-logs/): Automatic Docker and Kubernetes container log collection with formats and filters
- [OTLP Receivers](https://docs.bleemeo.com/logs/otlp-receivers/): Receive logs via OpenTelemetry gRPC and HTTP endpoints
- [Log Formats & Filters](https://docs.bleemeo.com/logs/log-formats/): Built-in log formats, custom format definitions, and filter reference
- [Log Metrics (Legacy)](https://docs.bleemeo.com/logs/log-metrics/): Generate metrics from logs using Fluent Bit with regex pattern matching

## Prometheus

- [Prometheus Overview](https://docs.bleemeo.com/prometheus/): How Bleemeo integrates with the Prometheus ecosystem
- [PromQL Guide](https://docs.bleemeo.com/prometheus/promql/): Learn PromQL with practical examples for dashboards and alerts
- [PromQL Reference](https://docs.bleemeo.com/prometheus/promql-reference/): Quick reference for PromQL syntax, selectors, operators, and functions

## Administration

- [Free Trial](https://docs.bleemeo.com/administration/trial/): 15-day free trial with all Professional plan features, no credit card required
- [Plans & Pricing](https://docs.bleemeo.com/administration/plan/): Free, Starter, and Professional plans comparison
- [Billing & Invoices](https://docs.bleemeo.com/administration/invoice/): Usage-based billing for servers, containers, monitors, and metrics
- [Payment Methods](https://docs.bleemeo.com/administration/payment-mean/): Credit card, SEPA direct debit, or bank transfer via Stripe
- [Reservations & Discounts](https://docs.bleemeo.com/administration/reservation/): Save up to 20% with 12-36 month commitments
- [Vouchers & Credits](https://docs.bleemeo.com/administration/voucher/): Apply promotional vouchers and reservation credits
- [Users & Permissions](https://docs.bleemeo.com/administration/users/): Manage team access with roles and two-factor authentication
- [Sandbox Mode](https://docs.bleemeo.com/administration/sandbox-mode/): Explore features with demo data before connecting servers

## Mobile Application

- [Mobile Application](https://docs.bleemeo.com/mobile-application/): iOS and Android apps for monitoring alerts and dashboards on the go

## API

- [REST API Overview](https://docs.bleemeo.com/api/usage/): Access monitoring data programmatically with the REST API and official SDKs
- [API Authentication](https://docs.bleemeo.com/api/authentication/): Authenticate with Basic auth or JSON Web Tokens (JWT)
- [API Rate Limits](https://docs.bleemeo.com/api/limits/): Rate limiting and best practices for retry logic
- [API Reference](https://docs.bleemeo.com/api/reference/): Complete API reference with all endpoints, parameters, and response schemas

## Open Source

### SquirrelDB

- [SquirrelDB](https://docs.bleemeo.com/squirreldb/): Open Source Prometheus-compatible time series database based on Cassandra
- [Getting Started](https://docs.bleemeo.com/squirreldb/getting-started/): Install and configure SquirrelDB
- [Installation](https://docs.bleemeo.com/squirreldb/getting-started/installation/): Deploy with Docker, Kubernetes, or as a single binary
- [Configuration](https://docs.bleemeo.com/squirreldb/getting-started/configuration/): Configure with YAML files and environment variables
- [Features](https://docs.bleemeo.com/squirreldb/features/): Pre-aggregation, metrics expiration, multi-tenancy, and mutable labels
- [High Availability](https://docs.bleemeo.com/squirreldb/high-availability/): Scalability and high availability with Cassandra
- [Metrics](https://docs.bleemeo.com/squirreldb/metrics/): Internal Prometheus metrics for monitoring SquirrelDB health
- [Troubleshooting](https://docs.bleemeo.com/squirreldb/troubleshooting/): Debug endpoints and index dump

### Bleemeo Community Edition

- [Community Edition](https://docs.bleemeo.com/community/): Prometheus-based open source monitoring solution with MQTT and Cassandra
- [Getting Started](https://docs.bleemeo.com/community/installation/): Install the self-hosted monitoring solution
- [Docker Installation](https://docs.bleemeo.com/community/installation/docker/): Deploy the complete stack with Docker
- [Kubernetes Installation](https://docs.bleemeo.com/community/installation/kubernetes/): Deploy with Kustomize on Kubernetes
- [Deploy Agents](https://docs.bleemeo.com/community/installation/agent/): Install Glouton monitoring agent for community edition
- [Configuration](https://docs.bleemeo.com/community/installation/configuration/): Access the local panel and configure dashboards
- [High Availability](https://docs.bleemeo.com/community/high-availability/): Scale all components - SquirrelDB, Cassandra, NATS, and Redis
- [Security](https://docs.bleemeo.com/community/security/): Encrypt and authenticate all network communications