Merge branch 'main' into metadata-update-2025-07-01

Author: jcatera-splunk

metric-metadata/ackextension.yaml

@@ -1,5 +1,10 @@
+display_name: ACK Extension
 type: ack
 
+description: |
+  This extension allows acking of data upon successful processing. The upstream agent can choose to send event again
+  if ack fails.
+
 status:
   class: extension
   stability:

metric-metadata/activedirectorydsreceiver.yaml

@@ -1,5 +1,10 @@
+display_name: Active Directory Domain Services Receiver
 type: active_directory_ds
 
+description: |
+  The Active Directory Domain Services Receiver scrapes metrics relating to an Active Directory domain controller using
+  the Windows Performance Counters.
+
 status:
   class: receiver
   stability:
@@ -10,31 +15,37 @@ status:
     seeking_new: true
   unsupported_platforms: [darwin, linux]
 
+reaggregation_enabled: true
+
 attributes:
+  bind_type:
+    name_override: type
+    description: The type of bind to the domain server.
+    type: string
+    requirement_level: recommended
+    enum:
+      - server
+      - client
   direction:
     description: The direction of data flow.
     type: string
+    requirement_level: recommended
     enum:
       - sent
       - received
   network_data_type:
     name_override: type
     description: The type of network data sent.
     type: string
+    requirement_level: recommended
     enum:
       - compressed
       - uncompressed
-  value_type:
-    name_override: type
-    description: The type of value sent.
-    type: string
-    enum:
-      - distinguished_names
-      - other
   operation_type:
     name_override: type
     description: The type of operation.
     type: string
+    requirement_level: recommended
     enum:
       - read
       - write
@@ -43,86 +54,88 @@ attributes:
     name_override: type
     description: The type of suboperation.
     type: string
+    requirement_level: recommended
     enum:
       - security_descriptor_propagations_event
       - search
   sync_result:
     name_override: result
     description: The result status of the sync request.
     type: string
+    requirement_level: recommended
     enum:
       - success
       - schema_mismatch
       - other
-  bind_type:
+  value_type:
     name_override: type
-    description: The type of bind to the domain server.
+    description: The type of value sent.
     type: string
+    requirement_level: recommended
     enum:
-      - server
-      - client
+      - distinguished_names
+      - other
 metrics:
-  active_directory.ds.replication.network.io:
-    description: "The amount of network data transmitted by the Directory Replication Agent."
-    unit: By
-    sum:
-      monotonic: true
-      aggregation_temporality: cumulative
-      value_type: int
-    attributes: [direction, network_data_type]
-    enabled: true
-  active_directory.ds.replication.sync.object.pending:
-    description: "The number of objects remaining until the full sync completes for the Directory Replication Agent."
-    unit: "{objects}"
+  active_directory.ds.bind.rate:
+    description: "The number of binds per second serviced by this domain controller."
+    unit: "{binds}/s"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
-      value_type: int
+      value_type: double
+    attributes: [bind_type]
     enabled: true
-  active_directory.ds.replication.sync.request.count:
-    description: "The number of sync requests made by the Directory Replication Agent."
-    unit: "{requests}"
-    sum:
-      monotonic: true
-      aggregation_temporality: cumulative
+    stability: development
+  active_directory.ds.ldap.bind.last_successful.time:
+    description: "The amount of time taken for the last successful LDAP bind."
+    unit: "ms"
+    gauge:
       value_type: int
-    attributes: [sync_result]
     enabled: true
-  active_directory.ds.replication.object.rate:
-    description: "The number of objects transmitted by the Directory Replication Agent per second."
-    unit: "{objects}/s"
+    stability: development
+  active_directory.ds.ldap.bind.rate:
+    description: "The number of successful LDAP binds per second."
+    unit: "{binds}/s"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
       value_type: double
-    attributes: [direction]
     enabled: true
-  active_directory.ds.replication.property.rate:
-    description: "The number of properties transmitted by the Directory Replication Agent per second."
-    unit: "{properties}/s"
+    stability: development
+  active_directory.ds.ldap.client.session.count:
+    description: "The number of connected LDAP client sessions."
+    unit: "{sessions}"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
-      value_type: double
-    attributes: [direction]
+      value_type: int
     enabled: true
-  active_directory.ds.replication.value.rate:
-    description: "The number of values transmitted by the Directory Replication Agent per second."
-    unit: "{values}/s"
+    stability: development
+  active_directory.ds.ldap.search.rate:
+    description: "The number of LDAP searches per second."
+    unit: "{searches}/s"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
       value_type: double
-    attributes: [direction, value_type]
     enabled: true
-  active_directory.ds.replication.operation.pending:
-    description: "The number of pending replication operations for the Directory Replication Agent."
-    unit: "{operations}"
+    stability: development
+  active_directory.ds.name_cache.hit_rate:
+    description: "The percentage of directory object name component lookups that are satisfied by the Directory System Agent's name cache."
+    unit: "%"
+    gauge:
+      value_type: double
+    enabled: true
+    stability: development
+  active_directory.ds.notification.queued:
+    description: "The number of pending update notifications that have been queued to push to clients."
+    unit: "{notifications}"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
       value_type: int
     enabled: true
+    stability: development
   active_directory.ds.operation.rate:
     description: "The number of operations performed per second."
     unit: "{operations}/s"
@@ -132,84 +145,103 @@ metrics:
       value_type: double
     attributes: [operation_type]
     enabled: true
-  active_directory.ds.name_cache.hit_rate:
-    description: "The percentage of directory object name component lookups that are satisfied by the Directory System Agent's name cache."
-    unit: "%"
-    gauge:
-      value_type: double
+    stability: development
+  active_directory.ds.replication.network.io:
+    description: "The amount of network data transmitted by the Directory Replication Agent."
+    unit: By
+    sum:
+      monotonic: true
+      aggregation_temporality: cumulative
+      value_type: int
+    attributes: [direction, network_data_type]
     enabled: true
-  active_directory.ds.notification.queued:
-    description: "The number of pending update notifications that have been queued to push to clients."
-    unit: "{notifications}"
+    stability: development
+  active_directory.ds.replication.object.rate:
+    description: "The number of objects transmitted by the Directory Replication Agent per second."
+    unit: "{objects}/s"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
-      value_type: int
+      value_type: double
+    attributes: [direction]
     enabled: true
-  active_directory.ds.security_descriptor_propagations_event.queued:
-    description: "The number of security descriptor propagation events that are queued for processing."
-    unit: "{events}"
+    stability: development
+  active_directory.ds.replication.operation.pending:
+    description: "The number of pending replication operations for the Directory Replication Agent."
+    unit: "{operations}"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
       value_type: int
     enabled: true
-  active_directory.ds.suboperation.rate:
-    description: "The rate of sub-operations performed."
-    unit: "{suboperations}/s"
+    stability: development
+  active_directory.ds.replication.property.rate:
+    description: "The number of properties transmitted by the Directory Replication Agent per second."
+    unit: "{properties}/s"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
       value_type: double
-    attributes: [suboperation_type]
+    attributes: [direction]
     enabled: true
-  active_directory.ds.bind.rate:
-    description: "The number of binds per second serviced by this domain controller."
-    unit: "{binds}/s"
+    stability: development
+  active_directory.ds.replication.sync.object.pending:
+    description: "The number of objects remaining until the full sync completes for the Directory Replication Agent."
+    unit: "{objects}"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
-      value_type: double
-    attributes: [bind_type]
+      value_type: int
     enabled: true
-  active_directory.ds.thread.count:
-    description: "The number of threads in use by the directory service."
-    unit: "{threads}"
+    stability: development
+  active_directory.ds.replication.sync.request.count:
+    description: "The number of sync requests made by the Directory Replication Agent."
+    unit: "{requests}"
     sum:
-      monotonic: false
+      monotonic: true
       aggregation_temporality: cumulative
       value_type: int
+    attributes: [sync_result]
     enabled: true
-  active_directory.ds.ldap.client.session.count:
-    description: "The number of connected LDAP client sessions."
-    unit: "{sessions}"
+    stability: development
+  active_directory.ds.replication.value.rate:
+    description: "The number of values transmitted by the Directory Replication Agent per second."
+    unit: "{values}/s"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
-      value_type: int
+      value_type: double
+    attributes: [direction, value_type]
     enabled: true
-  active_directory.ds.ldap.bind.last_successful.time:
-    description: "The amount of time taken for the last successful LDAP bind."
-    unit: "ms"
-    gauge:
+    stability: development
+  active_directory.ds.security_descriptor_propagations_event.queued:
+    description: "The number of security descriptor propagation events that are queued for processing."
+    unit: "{events}"
+    sum:
+      monotonic: false
+      aggregation_temporality: cumulative
       value_type: int
     enabled: true
-  active_directory.ds.ldap.bind.rate:
-    description: "The number of successful LDAP binds per second."
-    unit: "{binds}/s"
+    stability: development
+  active_directory.ds.suboperation.rate:
+    description: "The rate of sub-operations performed."
+    unit: "{suboperations}/s"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
       value_type: double
+    attributes: [suboperation_type]
     enabled: true
-  active_directory.ds.ldap.search.rate:
-    description: "The number of LDAP searches per second."
-    unit: "{searches}/s"
+    stability: development
+  active_directory.ds.thread.count:
+    description: "The number of threads in use by the directory service."
+    unit: "{threads}"
     sum:
       monotonic: false
       aggregation_temporality: cumulative
-      value_type: double
+      value_type: int
     enabled: true
+    stability: development
 
 # TODO: Update the receiver to pass the tests
 tests: