Architecture
groundcover stores the metrics it creates in a Prometheus compatible datasource.
This datasource is deployed in-cluster inside your environment and under your control so they can be immediately added to your Grafana, enriching your current monitoring experience with highly intimate and granular insights about your applications and infrastructure.
eBPF sensor
groundcover's data collection and aggregation sensor. The sensor is deployed as a DaemonSet called alligator, running a single pod in each node in the cluster.backend
groundcover's inCloud data backend and its connector to the groundcover cloud. The groundcover backend contains Pods that manage the data aggregation and data stores for the logs, metrics, traces and events that are created by the groundcover sensor and stored in-cloud.cloud
groundcover's control plane, taking care of routing the data from the groundcover backend to the user's browser. The groundcover cloud also handles and manages metadata around users, organizations etc.
Here's a detailed description of groundcover's unique in-cloud architecture:

When deploying groundcover you will see the following components running:
alligator
(DaemonSet)
alligator is groundcover's sensor. It is responsible for loading the eBPF program used to collect the data, aggregating the data (like creating high cardinality metrics on-the-fly) and capturing raw data (like API traces) based on its internal logic.metrics-ingester
(ReplicaSet)
metrics-ingester is responsible for the smart aggregation of all metrics reported from the the different alligators in the cluster. metrics-ingester controls the final metric cardinality before it's deposited into the time-series database and other mechanisms like series aging, report interval etc.k8s-watcher
(ReplicaSet)
k8s-watcher is responsible for gathering and clustering all Kubernetes metadata in the current cluster.clickhouse
(StatefulSet)
ClickHouse is a resource efficient database (ClickHouse) that supports multiple type of datasources. It is used for the persistent storage of all collected logs, traces and events. ClickHouse supports SQL as its log query language.opentelemetry-collector
(ReplicaSet)
The OpenTelemetry Collector offers a vendor-agnostic implementation of how to receive, process and export telemetry data. It is used to receive, convert and retarget all logs collected from the different alligators into the persistant storage database.victoria-metrics
(StatefulSet)
VictoriaMetrics (VictoriaMetrics) is a time-series database, used for the persistent storage of all collected metrics. VictoriaMetrics supports a PromQL query interface, so it can be treated as a Prometheus compatible datasource.victoria-metrics-agent
(ReplicaSet)
vmagent is a tiny agent which helps collect metrics from various sources. It is used for collecting groundcover's internal metrics.portal
(ReplicaSet)
portal is responsible for connecting the customer's cluster to groundcover's cloud backend, and allow permitted users to access their in-cloud data.
Last modified 2mo ago