This is an automated email from the ASF dual-hosted git repository.
wusheng pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/skywalking.git
The following commit(s) were added to refs/heads/master by this push:
new e92c3480a3 Add a statement for MAL practice. (#11985)
e92c3480a3 is described below
commit e92c3480a36f85f0088e073b9360586afe1ea0e2
Author: 吴晟 Wu Sheng <wu.sh...@foxmail.com>
AuthorDate: Tue Mar 5 14:09:02 2024 +0800
Add a statement for MAL practice. (#11985)
---
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..6a57b3b165 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 from 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}
