From ef7f036f59353cb50c9ad54e878bfef8ec2e7720 Mon Sep 17 00:00:00 2001 From: Kim Nylander Date: Fri, 20 Dec 2024 21:39:56 -0500 Subject: [PATCH] Add zone-aware ingesters doc --- .../tempo/operations/zone-aware-ingesters.md | 26 +++++++++++++++++++ 1 file changed, 26 insertions(+) create mode 100644 docs/sources/tempo/operations/zone-aware-ingesters.md diff --git a/docs/sources/tempo/operations/zone-aware-ingesters.md b/docs/sources/tempo/operations/zone-aware-ingesters.md new file mode 100644 index 00000000000..79fec387686 --- /dev/null +++ b/docs/sources/tempo/operations/zone-aware-ingesters.md @@ -0,0 +1,26 @@ +--- +title: Zone-aware ingesters +menuTitle: Zone-aware ingesters +description: Configure zone-aware ingesters for Tempo +weight: 900 +--- + +# Zone-aware replication for ingesters + +Zone awareness is a feature that ensures data is replicated across failure domains (which we refer to as “zones”) to provide greater reliability. +A failure domain is whatever you define it to be, but commonly may be an availability zone, data center, or server rack. + +When zone awareness is enabled for ingesters, incoming trace data is guaranteed to be replicated to ingesters in different zones. +This allows the system to withstand the loss of one or more zones (depending on the replication factor). + +Example: + +```yaml +# use the following fields in _config field of JSonnet config, to enable zone-aware ingesters. + multi_zone_ingester_enabled: false, + multi_zone_ingester_migration_enabled: false, + multi_zone_ingester_replicas: 0, + multi_zone_ingester_max_unavailable: 25, +``` + +For an configuration, refer to the [JSonnet microservices operations example](https://github.com/grafana/tempo/blob/main/operations/jsonnet/microservices/README.md) \ No newline at end of file