Release: Bump version to 12.3.1 (#113481) (#113948)

2025-11-14 18:03:46 +00:00
parent 02350c2f54
commit e48430c798
96 changed files with 8114 additions and 181 deletions
@@ -0,0 +1,86 @@
+---
+description: A reference for the JSON annotations schema used with Observability as Code.
+keywords:
+  - configuration
+  - as code
+  - as-code
+  - dashboards
+  - git integration
+  - git sync
+  - github
+  - annotations
+labels:
+  products:
+    - cloud
+    - enterprise
+    - oss
+menuTitle: annotations schema
+title: annotations
+weight: 100
+canonical: https://grafana.com/docs/grafana/latest/as-code/observability-as-code/schema-v2/annotations-schema/
+aliases:
+  - ../../../observability-as-code/schema-v2/annotations-schema/ # /docs/grafana/next/observability-as-code/schema-v2/annotations-schema/
+---
+
+# `annotations`
+
+The configuration for the list of annotations that are associated with the dashboard.
+
+```json
+  "annotations": [
+    {
+      "kind": "AnnotationQuery",
+      "spec": {
+        "builtIn": false,
+        "datasource": {
+          "type": "",
+          "uid": ""
+        },
+        "enable": false,
+        "hide": false,
+        "iconColor": "",
+        "name": ""
+      }
+    }
+  ],
+```
+
+`AnnotationsQueryKind` consists of:
+
+- kind: "AnnotationQuery"
+- spec: [AnnotationQuerySpec](#annotationqueryspec)
+
+## `AnnotationQuerySpec`
+
+| Name       | Type/Definition                                                   |
+| ---------- | ----------------------------------------------------------------- |
+| datasource | [`DataSourceRef`](#datasourceref)                                 |
+| query      | [`DataQueryKind`](#dataquerykind)                                 |
+| enable     | bool                                                              |
+| hide       | bool                                                              |
+| iconColor  | string                                                            |
+| name       | string                                                            |
+| builtIn    | bool. Default is `false`.                                         |
+| filter     | [`AnnotationPanelFilter`](#annotationpanelfilter)                 |
+| options    | `[string]`: A catch-all field for datasource-specific properties. |
+
+### `DataSourceRef`
+
+| Name  | Usage                              |
+| ----- | ---------------------------------- |
+| type? | string. The plugin type-id.        |
+| uid?  | The specific data source instance. |
+
+### `DataQueryKind`
+
+| Name | Type   |
+| ---- | ------ |
+| kind | string |
+| spec | string |
+
+### `AnnotationPanelFilter`
+
+| Name     | Type/Definition                                                                |
+| -------- | ------------------------------------------------------------------------------ |
+| exclude? | bool. Should the specified panels be included or excluded. Default is `false`. |
+| ids      | `[...uint8]`. Panel IDs that should be included or excluded.                   |