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/06/16 14:36:51 UTC
(skywalking) branch master updated: Fix links in the titles. (#12335)
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 6e5ac57c3a Fix links in the titles. (#12335)
6e5ac57c3a is described below
commit 6e5ac57c3ad4d22d9bc0b6edb0bd4aa076da8f26
Author: 吴晟 Wu Sheng <wu...@foxmail.com>
AuthorDate: Sun Jun 16 22:36:46 2024 +0800
Fix links in the titles. (#12335)
---
docs/en/api/promql-service.md | 52 +++++++++++++++++++++++++++++++++----------
1 file changed, 40 insertions(+), 12 deletions(-)
diff --git a/docs/en/api/promql-service.md b/docs/en/api/promql-service.md
index b9497f5bcc..8efb66e82f 100644
--- a/docs/en/api/promql-service.md
+++ b/docs/en/api/promql-service.md
@@ -12,20 +12,26 @@ The following doc describes the details of the supported protocol and compared i
If not mentioned, it will not be supported by default.
### Time series Selectors
-#### [Instant Vector Selectors](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors)
+#### Instant Vector Selectors
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/basics/#instant-vector-selectors)
+
For example: select metric `service_cpm` which the service is `$service` and the layer is `$layer`.
```text
service_cpm{service='$service', layer='$layer'}
```
**Note: The label matching operators only support `=` instead of regular expressions.**
-#### [Range Vector Selectors](https://prometheus.io/docs/prometheus/latest/querying/basics/#range-vector-selectors)
+#### Range Vector Selectors
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/basics/#range-vector-selectors)
+
For example: select metric `service_cpm` which the service is `$service` and the layer is `$layer` within the last 5 minutes.
```text
service_cpm{service='$service', layer='$layer'}[5m]
```
-#### [Time Durations](https://prometheus.io/docs/prometheus/latest/querying/basics/#time-durations)
+#### Time Durations
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/basics/#time-durations)
+
| Unit | Definition | Support |
|------|--------------|---------|
| ms | milliseconds | yes |
@@ -37,7 +43,10 @@ service_cpm{service='$service', layer='$layer'}[5m]
| y | years | **no** |
### Binary operators
-#### [Arithmetic binary operators](https://prometheus.io/docs/prometheus/latest/querying/operators/#arithmetic-binary-operators)
+#### Arithmetic binary operators
+
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/operators/#arithmetic-binary-operators)
+
| Operator | Definition | Support |
|----------|----------------------|---------|
| + | addition | yes |
@@ -67,7 +76,10 @@ service_cpm{service='$service', layer='$layer'} + service_cpm{service='$service'
**Note: The operations between vectors require the same metric and labels, and don't support [Vector matching](https://prometheus.io/docs/prometheus/latest/querying/operators/#vector-matching).**
-#### [Comparison binary operators](https://prometheus.io/docs/prometheus/latest/querying/operators/#comparison-binary-operators)
+#### Comparison binary operators
+
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/operators/#comparison-binary-operators)
+
| Operator | Definition | Support |
|----------|------------------|---------|
| == | equal | yes |
@@ -98,7 +110,10 @@ service_cpm{service='service_A', layer='$layer'} > service_cpm{service='service_
#### Expression queries
-##### [Instant queries](https://prometheus.io/docs/prometheus/latest/querying/api/#instant-queries)
+##### Instant queries
+
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/api/#instant-queries)
+
```text
GET|POST /api/v1/query
```
@@ -138,7 +153,10 @@ Result:
}
```
-##### [Range queries](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)
+##### Range queries
+
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/api/#range-queries)
+
```text
GET|POST /api/v1/query_range
```
@@ -204,7 +222,9 @@ Result:
#### Querying metadata
-##### [Finding series by label matchers](https://prometheus.io/docs/prometheus/latest/querying/api/#finding-series-by-label-matchers)
+##### Finding series by label matchers
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/api/#finding-series-by-label-matchers)
+
```text
GET|POST /api/v1/series
```
@@ -264,7 +284,9 @@ Result:
- instance_traffic
- endpoint_traffic
-#### [Getting label names](https://prometheus.io/docs/prometheus/latest/querying/api/#getting-label-names)
+#### Getting label names
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/api/#getting-label-names)
+
```text
GET|POST /api/v1/labels
```
@@ -295,7 +317,9 @@ Result:
}
```
-#### [Querying label values](https://prometheus.io/docs/prometheus/latest/querying/api/#querying-label-values)
+#### Querying label values
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/api/#querying-label-values)
+
```text
GET /api/v1/label/<label_name>/values
```
@@ -333,7 +357,9 @@ Result:
}
```
-#### [Querying metric metadata](https://prometheus.io/docs/prometheus/latest/querying/api/#querying-metric-metadata)
+#### Querying metric metadata
+[Prometheus Docs Reference](https://prometheus.io/docs/prometheus/latest/querying/api/#querying-metric-metadata)
+
```text
GET /api/v1/metadata
```
@@ -381,7 +407,7 @@ Result:
## Metrics Type For Query
-### Supported Metrics [Scope](../../../oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/query/enumeration/Scope.java)(Catalog)
+### Supported Metrics Scope(Catalog)
Not all scopes are supported for now, please check the following table:
| Scope | Support |
@@ -395,6 +421,8 @@ Not all scopes are supported for now, please check the following table:
| Process | no |
| ProcessRelation | no |
+All Scopes could be found [here](../../../oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/query/enumeration/Scope.java).
+
### General labels
Each metric contains general labels: [layer](../../../oap-server/server-core/src/main/java/org/apache/skywalking/oap/server/core/analysis/Layer.java).
Different metrics will have different labels depending on their Scope and metric value type.