Frequently Asked Questions
Common questions about Apache HertzBeat monitoring system. Can't find your answer? Visit our community page for support.
What is Apache HertzBeat?
Apache HertzBeat is an AI-powered, agentless open source real-time monitoring system. It unifies metrics collection, log aggregation, alerting, and notification in a single platform without requiring agent installation.
Does HertzBeat require agent installation?
No. HertzBeat uses agentless monitoring via native protocols (HTTP, SNMP, JMX, SSH, JDBC). You only need to provide IP, port, and credentials through the web interface.
How do I install HertzBeat?
Run this single Docker command: docker run -d -p 1157:1157 -p 1158:1158 --name hertzbeat apache/hertzbeat. Then access http://localhost:1157 with default credentials admin/hertzbeat.
What systems can HertzBeat monitor?
HertzBeat monitors 200+ services including databases (MySQL, PostgreSQL, MongoDB, Redis, Oracle, SQL Server), operating systems (Linux, Windows, Unix), middleware (Tomcat, Kafka, Zookeeper, RabbitMQ, Nginx), cloud (Kubernetes, Docker), and networks (Cisco, Huawei, HPE switches).
Can I create custom monitoring templates?
Yes. Create YML templates via the web UI to monitor any service. Templates define metrics, collection protocols, and thresholds without coding.
Is HertzBeat compatible with Prometheus?
Yes. HertzBeat supports Prometheus protocol and can collect metrics from Prometheus exporters.
How does HertzBeat compare to Prometheus + Grafana?
HertzBeat provides a unified platform including collection, alerting, and notifications. Prometheus + Grafana requires separate components for alerts (Alertmanager) and lacks built-in multi-channel notifications.
What notification channels does HertzBeat support?
Email, Discord, Slack, Telegram, DingTalk, WeChat, FeiShu, SMS, and Webhook.
Can HertzBeat scale for large deployments?
Yes. Deploy collector clusters for horizontal scaling. Collectors auto-balance tasks and provide failover for high availability.
What license does HertzBeat use?
Apache License 2.0. HertzBeat is completely open source with no monitoring limits or license restrictions.
What are HertzBeat's system requirements?
Minimum: 2 CPU cores, 4GB RAM (8GB recommended), 10GB disk space, Docker 20.10+ or Java 17+. Supported on Linux, macOS, Windows.
How do I upgrade HertzBeat?
For Docker: stop and remove the old container, pull the latest image, and run a new container. For package installations, download the new version, backup your configuration, and replace the installation directory.
What database does HertzBeat use?
HertzBeat uses H2 embedded database by default. For production, configure external databases: MySQL or PostgreSQL for metadata, VictoriaMetrics, IoTDB, TDengine, or InfluxDB for time-series data.
Can HertzBeat monitor isolated networks?
Yes, through cloud-edge collaboration. Deploy edge collectors in isolated networks that report to the centralized HertzBeat server for unified management.
Does HertzBeat have a status page feature?
Yes. HertzBeat includes a status page builder to create public status pages (similar to GitHub Status) that communicate service availability to users.
How often is HertzBeat updated?
HertzBeat releases new versions approximately every 2-3 months with bug fixes, security patches, and new features.
Is HertzBeat production-ready?
Yes. HertzBeat is an Apache Software Foundation project used in production by many organizations. It supports high-performance clustering and has been included in the CNCF Observability Landscape.
Can I contribute to HertzBeat?
Yes. HertzBeat is open source under Apache License 2.0. Contributions are welcome through GitHub pull requests, documentation improvements, bug reports, and feature suggestions.
Still have questions?
Documentation: https://hertzbeat.apache.org/docs/
GitHub Discussions: https://github.com/apache/hertzbeat/discussions
Community: Contact us