You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@skywalking.apache.org by wu...@apache.org on 2024/03/05 05:58:05 UTC

(skywalking) 01/01: Add a statement for MAL practice.

This is an automated email from the ASF dual-hosted git repository.

wusheng pushed a commit to branch wu-sheng-patch-1
in repository https://gitbox.apache.org/repos/asf/skywalking.git

commit 15af3e6b73f91295b71fe5db92cf34864718c150
Author: 吴晟 Wu Sheng <wu...@foxmail.com>
AuthorDate: Tue Mar 5 13:57:59 2024 +0800

    Add a statement for MAL practice.
---
 docs/en/concepts-and-designs/mal.md | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/docs/en/concepts-and-designs/mal.md b/docs/en/concepts-and-designs/mal.md
index 50ff6decc6..43f236445c 100644
--- a/docs/en/concepts-and-designs/mal.md
+++ b/docs/en/concepts-and-designs/mal.md
@@ -175,6 +175,14 @@ instance_trace_count{az="az-1"} 133 // 100 + 33
 instance_trace_count{az="az-3"} 20
 ```
 
+___
+**Note, aggregation operations affect the samples for one bulk only. If the metrics are reported parallel from multiple instances/nodes
+through different SampleFamily, this aggregation would NOT work.**
+
+In the best practice for this scenario, build the metric with labels that represent each instance/node. Then use the 
+[AggregateLabels Operation in MQE](../api/metrics-query-expression.md#aggregatelabels-operation) to aggregate the metrics.
+___
+
 ### Function
 
 `Duration` is a textual representation of a time range. The formats accepted are based on the ISO-8601 duration format {@code PnDTnHnMn.nS}