Skip to content

Commit 6cb7206

Browse files
SuperQSuperQ
authored
Release v0.14.0 (#226)
Release v0.14.0 * [FEATURE] cache descriptors to reduce API calls #218 --------- Signed-off-by: SuperQ <[email protected]>
1 parent 50c3be2 commit 6cb7206

File tree

6 files changed

+117
-63
lines changed

6 files changed

+117
-63
lines changed

‎CHANGELOG.md‎

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,9 @@
11
## master / unreleased
22

3+
## 0.14.0 / 2023-05-26
4+
5+
* [FEATURE] cache descriptors to reduce API calls #218
6+
37
## 0.13.0 / 2023-01-25
48

59
* [FEATURE] Add `monitoring.aggregate-deltas` and `monitoring.aggregate-deltas-ttl` flags which allow aggregating DELTA

‎README.md‎

Lines changed: 30 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -76,18 +76,36 @@ If you are still using the legacy [Access scopes][access-scopes], the `https://w
7676

7777
### Flags
7878

79-
| Flag | Required | Default | Description |
80-
| --------------------------------- | -------- |---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
81-
| `google.project-id` | No | GCloud SDK auto-discovery | Comma seperated list of Google Project IDs |
82-
| `monitoring.metrics-ingest-delay` | No | | Offsets metric collection by a delay appropriate for each metric type, e.g. because bigquery metrics are slow to appear |
83-
| `monitoring.metrics-type-prefixes` | Yes | | Comma separated Google Stackdriver Monitoring Metric Type prefixes (see [example][metrics-prefix-example] and [available metrics][metrics-list]) |
84-
| `monitoring.metrics-interval` | No | `5m` | Metric's timestamp interval to request from the Google Stackdriver Monitoring Metrics API. Only the most recent data point is used |
85-
| `monitoring.metrics-offset` | No | `0s` | Offset (into the past) for the metric's timestamp interval to request from the Google Stackdriver Monitoring Metrics API, to handle latency in published metrics |
86-
| `monitoring.filters` | No | | Formatted string to allow filtering on certain metrics type |
87-
| `monitoring.aggregate-deltas` | No | | If enabled will treat all DELTA metrics as an in-memory counter instead of a gauge. Be sure to read [what to know about aggregating DELTA metrics](#what-to-know-about-aggregating-delta-metrics) |
88-
| `monitoring.aggregate-deltas-ttl` | No | `30m` | How long should a delta metric continue to be exported and stored after GCP stops producing it. Read [slow moving metrics](#slow-moving-metrics) to understand the problem this attempts to solve |
89-
| `web.listen-address` | No | `:9255` | Address to listen on for web interface and telemetry |
90-
| `web.telemetry-path` | No | `/metrics` | Path under which to expose Prometheus metrics |
79+
| Flag | Required | Default | Description |
80+
| ----------------------------------- | -------- |---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
81+
| `google.project-id` | No | GCloud SDK auto-discovery | Comma seperated list of Google Project IDs |
82+
| `monitoring.metrics-ingest-delay` | No | | Offsets metric collection by a delay appropriate for each metric type, e.g. because bigquery metrics are slow to appear |
83+
| `monitoring.drop-delegated-projects | No | No | Drop metrics from attached projects and fetch `project_id` only. |
84+
| `monitoring.metrics-type-prefixes` | Yes | | Comma separated Google Stackdriver Monitoring Metric Type prefixes (see [example][metrics-prefix-example] and [available metrics][metrics-list]) |
85+
| `monitoring.metrics-interval` | No | `5m` | Metric's timestamp interval to request from the Google Stackdriver Monitoring Metrics API. Only the most recent data point is used |
86+
| `monitoring.metrics-offset` | No | `0s` | Offset (into the past) for the metric's timestamp interval to request from the Google Stackdriver Monitoring Metrics API, to handle latency in published metrics |
87+
| `monitoring.filters` | No | | Formatted string to allow filtering on certain metrics type |
88+
| `monitoring.aggregate-deltas` | No | | If enabled will treat all DELTA metrics as an in-memory counter instead of a gauge. Be sure to read [what to know about aggregating DELTA metrics](#what-to-know-about-aggregating-delta-metrics) |
89+
| `monitoring.aggregate-deltas-ttl` | No | `30m` | How long should a delta metric continue to be exported and stored after GCP stops producing it. Read [slow moving metrics](#slow-moving-metrics) to understand the problem this attempts to solve |
90+
| `monitoring.descriptor-cache-ttl` | No | `0s` | How long should the metric descriptors for a prefixed be cached for |
91+
| `stackdriver.max-retries` | No | `0` | Max number of retries that should be attempted on 503 errors from stackdriver. |
92+
| `stackdriver.http-timeout` | No | `10s` | How long should stackdriver_exporter wait for a result from the Stackdriver API. |
93+
| `stackdriver.max-backoff=` | No | | Max time between each request in an exp backoff scenario. |
94+
| `stackdriver.backoff-jitter` | No | `1s | The amount of jitter to introduce in a exp backoff scenario. |
95+
| `stackdriver.retry-statuses` | No | `503` | The HTTP statuses that should trigger a retry. |
96+
| `web.config.file` | No | | [EXPERIMENTAL] Path to configuration file that can enable TLS or authentication. |
97+
| `web.listen-address` | No | `:9255` | Address to listen on for web interface and telemetry Repeatable for multiple addresses. |
98+
| `web.systemd-socket` | No | | Use systemd socket activation listeners instead of port listeners (Linux only). |
99+
| `web.stackdriver-telemetry-path` | No | "/metrics" | Path under which to expose Stackdriver metrics. |
100+
| `web.telemetry-path` | No | `/metrics` | Path under which to expose Prometheus metrics |
101+
102+
### TLS and basic authentication
103+
104+
The Stackdriver Exporter supports TLS and basic authentication.
105+
106+
To use TLS and/or basic authentication, you need to pass a configuration file
107+
using the `--web.config.file` parameter. The format of the file is described
108+
[in the exporter-toolkit repository](https://github.com/prometheus/exporter-toolkit/blob/master/docs/web-configuration.md).
91109

92110
### Metrics
93111

‎VERSION‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1 +1 @@
1-
0.13.0
1+
0.14.0

‎go.mod‎

Lines changed: 16 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
module github.com/prometheus-community/stackdriver_exporter
22

3-
go 1.18
3+
go 1.19
44

55
require (
66
github.com/PuerkitoBio/rehttp v1.1.0
@@ -10,11 +10,12 @@ require (
1010
github.com/onsi/ginkgo v1.16.5
1111
github.com/onsi/gomega v1.27.6
1212
github.com/prometheus/client_golang v1.15.1
13-
github.com/prometheus/client_model v0.3.0
14-
github.com/prometheus/common v0.42.0
15-
golang.org/x/net v0.9.0
16-
golang.org/x/oauth2 v0.7.0
17-
google.golang.org/api v0.121.0
13+
github.com/prometheus/client_model v0.4.0
14+
github.com/prometheus/common v0.44.0
15+
github.com/prometheus/exporter-toolkit v0.10.0
16+
golang.org/x/net v0.10.0
17+
golang.org/x/oauth2 v0.8.0
18+
google.golang.org/api v0.124.0
1819
)
1920

2021
require (
@@ -23,29 +24,33 @@ require (
2324
github.com/alecthomas/units v0.0.0-20211218093645-b94a6e3cc137 // indirect
2425
github.com/beorn7/perks v1.0.1 // indirect
2526
github.com/cespare/xxhash/v2 v2.2.0 // indirect
27+
github.com/coreos/go-systemd/v22 v22.5.0 // indirect
2628
github.com/fsnotify/fsnotify v1.4.9 // indirect
2729
github.com/go-logfmt/logfmt v0.5.1 // indirect
2830
github.com/golang/groupcache v0.0.0-20200121045136-8c9f03a8e57e // indirect
2931
github.com/golang/protobuf v1.5.3 // indirect
3032
github.com/google/go-cmp v0.5.9 // indirect
31-
github.com/google/s2a-go v0.1.3 // indirect
33+
github.com/google/s2a-go v0.1.4 // indirect
3234
github.com/google/uuid v1.3.0 // indirect
3335
github.com/googleapis/enterprise-certificate-proxy v0.2.3 // indirect
3436
github.com/googleapis/gax-go/v2 v2.8.0 // indirect
37+
github.com/jpillora/backoff v1.0.0 // indirect
3538
github.com/kr/text v0.2.0 // indirect
3639
github.com/matttproud/golang_protobuf_extensions v1.0.4 // indirect
40+
github.com/mwitkow/go-conntrack v0.0.0-20190716064945-2f068394615f // indirect
3741
github.com/nxadm/tail v1.4.8 // indirect
3842
github.com/prometheus/procfs v0.9.0 // indirect
39-
github.com/rogpeppe/go-internal v1.9.0 // indirect
4043
github.com/xhit/go-str2duration/v2 v2.1.0 // indirect
4144
go.opencensus.io v0.24.0 // indirect
42-
golang.org/x/crypto v0.1.0 // indirect
43-
golang.org/x/sys v0.7.0 // indirect
45+
golang.org/x/crypto v0.8.0 // indirect
46+
golang.org/x/sync v0.2.0 // indirect
47+
golang.org/x/sys v0.8.0 // indirect
4448
golang.org/x/text v0.9.0 // indirect
4549
google.golang.org/appengine v1.6.7 // indirect
4650
google.golang.org/genproto v0.0.0-20230410155749-daa745c078e1 // indirect
47-
google.golang.org/grpc v1.54.0 // indirect
51+
google.golang.org/grpc v1.55.0 // indirect
4852
google.golang.org/protobuf v1.30.0 // indirect
4953
gopkg.in/tomb.v1 v1.0.0-20141024135613-dd632973f1e7 // indirect
54+
gopkg.in/yaml.v2 v2.4.0 // indirect
5055
gopkg.in/yaml.v3 v3.0.1 // indirect
5156
)

0 commit comments

Comments
 (0)