diff --git a/proto/opamp.proto b/proto/opamp.proto index 3f84a18..1845e38 100644 --- a/proto/opamp.proto +++ b/proto/opamp.proto @@ -1046,6 +1046,11 @@ message AgentConfigFile { // Optional MIME Content-Type that describes what's in the body field, for // example "text/yaml". string content_type = 2; + + // Optional key/value pairs that provide additional metadata for this config + // file or section. Agents may use this field to report arbitrary attributes + // associated with the file. + repeated KeyValue attributes = 3; } ///////////////////////////////////////////////////////////////////////////////////// diff --git a/specification.md b/specification.md index 9e0443a..25d2344 100644 --- a/specification.md +++ b/specification.md @@ -2554,6 +2554,7 @@ following structure: message AgentConfigFile { bytes body = 1; string content_type = 2; + repeated KeyValue attributes = 3; } ``` @@ -2567,6 +2568,13 @@ reported in the Effective Configuration in the Agent's status report may be used for example by the Server to visualize the reported configuration nicely in a UI. +attributes is an optional field. It contains key/value pairs that provide +additional metadata for this configuration file or section. Agents MAY use +attributes to report arbitrary properties associated with a configuration file, +for example the origin of the file, the component that produced it, or other +Agent type-specific metadata. The interpretation of these attributes is Agent +type-specific and is outside the concerns of the OpAMP protocol. + #### Security Considerations Remote Configuration is a potentially dangerous functionality that may be