Skip to content

Commit 6a7467a

Browse files
mrafi97drichards-87NouemanKHAL
authored
Document Agent v7.80 windows_certificate tag flags (DataDog#23774)
* Document Agent v7.80 windows_certificate tag flags Expand the Tags section of the windows_certificate README to describe the six opt-in flags added in Agent v7.80 (datadog-agent#49740) and the tags each flag emits. * Update windows_certificate/README.md Co-authored-by: DeForest Richards <56796055+drichards-87@users.noreply.github.com> --------- Co-authored-by: DeForest Richards <56796055+drichards-87@users.noreply.github.com> Co-authored-by: NouemanKHAL <noueman.khalikine@datadoghq.com>
1 parent f1d77f5 commit 6a7467a

1 file changed

Lines changed: 20 additions & 0 deletions

File tree

windows_certificate/README.md

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,26 @@ The `policy_validation_flags` [suppress specific validation errors][12] that may
7272

7373
The integration automatically tags all metrics and service checks with the name of the store in the `certificate_store:<STORE>` tag. Certificate metrics and service checks are tagged with the certificate's subjects, thumbprints and serial numbers. CRL metrics and service checks are tagged with the CRL's issuer and thumbprint.
7474

75+
Beginning with Agent v7.80, six opt-in flags expose additional certificate metadata as tags on per-certificate metrics and service checks. Each flag defaults to `false`. Set the value to `true` in your instance configuration to emit the corresponding tags.
76+
77+
| Flag | Tags emitted |
78+
| --- | --- |
79+
| `certificate_template_tag` | `certificate_template`, `certificate_template_oid`, `certificate_template_major_version`, `certificate_template_minor_version` |
80+
| `enhanced_key_usage_tag` | `enhanced_key_usage` (one tag per EKU OID; well-known OIDs use short names) |
81+
| `friendly_name_tag` | `friendly_name` |
82+
| `subject_alternative_names_tag` | `subject_alt_name_dns`, `subject_alt_name_ip`, `subject_alt_name_email`, `subject_alt_name_uri` |
83+
| `issuer_tag` | `issuer_CN`, `issuer_O`, `issuer_OU`, and other issuer Distinguished Name components when present |
84+
| `signature_algorithm_tag` | `signature_algorithm` |
85+
86+
Example configuration that enables the issuer and signature algorithm tags:
87+
88+
```yaml
89+
instances:
90+
- certificate_store: ROOT
91+
issuer_tag: true
92+
signature_algorithm_tag: true
93+
```
94+
7595
### Validation
7696

7797
[Run the Agent's status subcommand][6] and look for `windows_certificate` under the Checks section.

0 commit comments

Comments
 (0)