Skip to content

Commit 2e1c7e0

Browse files
chore: improve wording
1 parent 6f3472a commit 2e1c7e0

File tree

1 file changed

+13
-13
lines changed

1 file changed

+13
-13
lines changed

content/en/agent/configuration/secrets-management.md

Lines changed: 13 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -835,44 +835,42 @@ On Windows, your executable must:
835835

836836
## Refreshing secrets at runtime
837837

838-
Starting in Agent version v7.67, you can configure the Agent to refresh resolved secrets at regular intervals without requiring a restart.
838+
Starting in Agent v7.67, configure the Agent to refresh resolved secrets without requiring a restart.
839839

840-
Secret refresh can be set as an interval:
840+
Set a refresh interval:
841841
```yaml
842842
secret_refresh_interval: 3600 # refresh every hour
843843
```
844844

845-
Or triggered manually:
845+
Or, trigger a refresh manually:
846846
```shell
847847
datadog-agent secret refresh
848848
```
849849

850850
### API/APP key refresh
851-
API/APP keys can be refreshed at runtime if they are pulled as secrets.
851+
API/APP keys pulled as secrets support runtime refresh.
852852

853-
To enable this, set `secret_refresh_interval` (in seconds) in your `datadog.yaml` file:
853+
You can enable this by setting `secret_refresh_interval` (in seconds) in `datadog.yaml`:
854854
```yaml
855855
api_key: ENC[<secret_handle>]
856856
857857
secret_refresh_interval: 3600 # refresh every hour
858858
```
859859

860-
By default the Agent randomly spreads its first refresh within the specified `secret_refresh_interval` window. This
861-
means that it resolves the API key at startup, then refreshes it within the first interval and every interval after that.
862-
This avoids having a fleet of Agents refreshing their API/APP key at the same time.
860+
By default, the Agent randomizes the initial refresh within the `secret_refresh_interval` window to prevent a fleet of
861+
Agents from refreshing simultaneously. The key is resolved at startup, then refreshed once within the first interval
862+
and every interval thereafter.
863863

864-
To prevent downtime, only invalidate the previous API key and APP key when your entire fleet of Agents has
865-
pulled the updated keys from your secret management solution. You can track usage of your API keys in the [Fleet
866-
Management](https://app.datadoghq.com/fleet) page.
864+
To prevent downtime, invalidate old keys only after your entire fleet has pulled the updated keys. You can track key
865+
usage on the [Fleet Management](https://app.datadoghq.com/fleet) page.
867866

868867
You can disable this behavior by setting:
869868
```yaml
870869
secret_refresh_scatter: false
871870
```
872871

873872
### Autodiscovery check secrets refresh
874-
As of Agent v7.76, scheduled [Autodiscovery][1] checks can refresh secrets at runtime as long as the configured template
875-
pulls secrets using the `ENC[]` syntax.
873+
Starting in Agent v7.76, scheduled [Autodiscovery][1] checks can refresh secrets at runtime if the template uses the `ENC[]` syntax.
876874

877875
```yaml
878876
labels:
@@ -895,6 +893,8 @@ annotations:
895893
}
896894
```
897895

896+
Now the Agent can trigger secrets refresh at either the interval set in `secret_refresh_interval` or manually with `datadog-agent secret refresh`.
897+
898898
### Enabling DDOT collector refresh
899899
If you are using [DDOT collector][6] and want to enable API/APP refresh you must add the following additional configuration to your `datadog.yaml` file:
900900
```

0 commit comments

Comments
 (0)