GCP metadata

aurbiztondo-splunk · aurbiztondo-splunk · commit 1f279097f137 · 2024-07-12T16:19:48.000+02:00
diff --git a/_includes/gdi/available-gcp.rst b/_includes/gdi/available-gcp.rst
@@ -0,0 +1,167 @@
+You can collect data from the following GCP services out-of-the-box:
+
+.. list-table::
+  :header-rows: 1
+  :widths: 40 40 10 10 
+  :width: 100%  
+
+  * - :strong:`Service name (to use in the API)`
+    - :strong:`Product name (as displayed in the GUI)`
+    - :strong:`Provides metrics`
+    - :strong:`Provides metadata (properties)`
+   
+  * - appengine
+    - App Engine
+    - :strong:`X`
+    - 
+   
+  * - bigquery
+    - BigQuery
+    - :strong:`X`
+    - 
+   
+  * - bigtable
+    - Cloud Bigtable
+    - :strong:`X`
+    - 
+   
+  * - cloudfunctions
+    - Cloud Functions
+    - :strong:`X`
+    - 
+   
+  * - cloudiot
+    - Cloud Internet of Things Core
+    - :strong:`X`
+    - 
+   
+  * - cloudsql
+    - Cloud SQL
+    - :strong:`X`
+    - 
+   
+  * - cloudtasks
+    - Cloud Tasks
+    - :strong:`X`
+    - 
+   
+  * - composer
+    - Cloud Composer
+    - :strong:`X`
+    - 
+   
+  * - compute
+    - Compute Engine
+    - :strong:`X`
+    - :strong:`X`
+   
+  * - container
+    - Container Engine
+    - :strong:`X`
+    - 
+   
+  * - dataflow
+    - Cloud Dataflow
+    - :strong:`X`
+    - 
+   
+  * - dataproc
+    - Cloud Dataproc
+    - :strong:`X`
+    - 
+   
+  * - datastore
+    - Cloud Datastore
+    - :strong:`X`
+    - 
+   
+  * - file
+    - Cloud Filestore
+    - :strong:`X`
+    - 
+   
+  * - firebasedatabase
+    - Firebase Database
+    - :strong:`X`
+    - 
+   
+  * - firebasehosting
+    - Firebase Hosting
+    - :strong:`X`
+    - 
+   
+  * - interconnect
+    - Cloud Interconnect Dedicated
+    - :strong:`X`
+    - 
+
+  * - knative
+    - Knative
+    - :strong:`X`
+    - 
+   
+  * - kubernetes
+    - Kubernetes (GKE)
+    - :strong:`X`
+    - :strong:`X`
+   
+  * - loadbalancing
+    - Compute Engine HTTP(S) Load Balancing
+    - :strong:`X`
+    - 
+   
+  * - logging
+    - Stackdriver Logging
+    - :strong:`X`
+    - 
+   
+  * - ml
+    - Cloud Machine Learning
+    - :strong:`X`
+    - 
+     
+  * - monitoring
+    - Stackdriver Monitoring
+    - :strong:`X`
+    - 
+   
+  * - pubsub
+    - Cloud Pub/Sub
+    - :strong:`X`
+    - 
+   
+  * - redis
+    - Memorystore for Redis
+    - :strong:`X`
+    - 
+   
+  * - router
+    - Cloud Router
+    - :strong:`X`
+    - 
+   
+  * - run
+    - Cloud Run
+    - :strong:`X`
+    - 
+   
+  * - serviceruntime
+    - Google Cloud Endpoints APIs
+    - :strong:`X`
+    - 
+   
+  * - spanner
+    - Cloud Spanner
+    - :strong:`X`
+    - :strong:`X`
+   
+  * - storage
+    - Cloud Storage
+    - :strong:`X`
+    - :strong:`X`
+   
+  * - vpn
+    - Cloud VPN
+    - :strong:`X`
+    - 
+   
diff --git a/gdi/get-data-in/connect/gcp/gcp-metrics.rst b/gdi/get-data-in/connect/gcp/gcp-metrics.rst
@@ -1,11 +1,11 @@
 .. _gcp-metrics:
 
-******************************************
-Google Cloud Monitoring metrics
-******************************************
+************************************************
+Google Cloud Monitoring metrics and metadata
+************************************************
 
 .. meta::
-   :description: Google Cloud Platform / GCP metrics in Splunk Observability Cloud.
+   :description: Google Cloud Platform / GCP metrics and metadata in Splunk Observability Cloud.
 
 .. toctree::
    :hidden:
@@ -14,17 +14,30 @@ After :ref:`connecting to GCP <get-started-gcp>`, metrics from Google Cloud Moni
 
 Metrics from Google Cloud Monitoring (formerly Stackdriver) contain dimensions that correspond to the Labels described in the Google Cloud metrics reference and the :new-page:`Monitored Resource Types <https://cloud.google.com/monitoring/api/resources>` reference. Use the ``monitored_resource`` dimension to determine which metric corresponds to a particular resource.
 
-Although you can configure :new-page:`Cloud Monitoring <https://cloud.google.com/monitoring/api/metrics_aws>` to monitor AWS metrics, the GCP integration with Splunk Observability Cloud does not ingest them by default. You can enter additional GCP service domains while configuring your integration. Such a configuration does not connect your Splunk Observability Cloud instance to AWS.
+Although you can configure :new-page:`Cloud Monitoring <https://cloud.google.com/monitoring/api/metrics_aws>` to monitor AWS metrics, the GCP integration with Splunk Observability Cloud does not ingest them by default. You can enter additional GCP service domains while configuring your integration. 
 
-Available GCP metrics
-================================
+Available GCP metrics and metadata
+========================================
 
-All metrics of supported services are included by default. 
+.. include:: /_includes/gdi/available-gcp.rst
 
-* Check the list of supported GCP services in Splunk Observability Cloud at :ref:`gcp-integrations`.
 * For a detailed list of the available Google Cloud Monitoring metrics, including services not supported out-of-the-box, see the official Google documentation at :new-page:`Google Cloud metrics <https://cloud.google.com/monitoring/api/metrics_gcp>`. 
 * To track and understand your consumption, see :ref:`monitor-imm-billing-usage`.
 
+GCP project metadata
+------------------------
+
+Splunk Observability Cloud also fetches the following properties of your synchronized GCP projects:
+
+* ``gcp_project_creation_time``
+* ``gcp_project_name``
+* ``gcp_project_number``
+* ``gcp_project_status``
+
+These properties are attached to the ``project_id`` dimension and are propagated to all MTSes with this dimension. 
+
+.. note:: To fetch these properties from your GCP subprojects you need to explicitly mention them in the integration configuration. 
+
 Organization metrics
 =================================
 
diff --git a/gdi/get-data-in/connect/gcp/gcp.rst b/gdi/get-data-in/connect/gcp/gcp.rst
@@ -10,7 +10,7 @@ Connect to Google Cloud Platform
 .. toctree::
    :hidden:
 
-   GCP metrics <gcp-metrics>
+   gcp-metrics
    Send GCP logs to Splunk Platform <gcp-logs>   
 
 With a Google Cloud Platform (GCP) integration in Splunk Observability Cloud, you can track your Google Cloud Monitoring metrics and monitor your GCP services in one place. To configure a GCP integration with Splunk Infrastructure Monitoring, check the prerequisites and follow the instructions on this document. You can also :ref:`use the API <gcp-api>` to connect to GCP. 
diff --git a/gdi/integrations/cloud-gcp.rst b/gdi/integrations/cloud-gcp.rst
@@ -12,105 +12,4 @@ To learn about GCP and Splunk Observability Cloud, read :ref:`get-started-gcp`.
 
 Splunk Observability Cloud supports certain services by default, but you can add any other GCP service you need to monitor. See :ref:`Start the integration <gcp-three>`. 
 
-You can collect data from the following GCP services out-of-the-box:
-
-.. list-table::
-  :header-rows: 1
-  :widths: 40 40 
-  :width: 100%  
-
-  * - :strong:`Service name (to use in the API)`
-    - :strong:`Product name (as displayed in the GUI)`
-
-  * - appengine
-    - App Engine
-
-  * - bigquery
-    - BigQuery
-
-  * - bigtable
-    - Cloud Bigtable
-
-  * - cloudfunctions
-    - Cloud Functions
-
-  * - cloudiot
-    - Cloud Internet of Things Core
-
-  * - cloudsql
-    - Cloud SQL
-
-  * - cloudtasks
-    - Cloud Tasks
-
-  * - composer
-    - Cloud Composer
-
-  * - compute
-    - Compute Engine
-
-  * - container
-    - Container Engine
-
-  * - dataflow
-    - Cloud Dataflow
-
-  * - dataproc
-    - Cloud Dataproc
-
-  * - datastore
-    - Cloud Datastore
-
-  * - file
-    - Cloud Filestore
-
-  * - firebasedatabase
-    - Firebase Database
-
-  * - firebasehosting
-    - Firebase Hosting
-
-  * - interconnect
-    - Cloud Interconnect Dedicated
-
-  * - knative
-    - Knative
-
-  * - kubernetes
-    - Kubernetes (GKE)
-
-  * - loadbalancing
-    - Compute Engine HTTP(S) Load Balancing
-
-  * - logging
-    - Stackdriver Logging
-
-  * - ml
-    - Cloud Machine Learning
-  
-  * - monitoring
-    - Stackdriver Monitoring
-
-  * - pubsub
-    - Cloud Pub/Sub
-
-  * - redis
-    - Memorystore for Redis
-
-  * - router
-    - Cloud Router
-
-  * - run
-    - Cloud Run
-
-  * - serviceruntime
-    - Google Cloud Endpoints APIs
-
-  * - spanner
-    - Cloud Spanner
-
-  * - storage
-    - Cloud Storage
-
-  * - vpn
-    - Cloud VPN
+.. include:: /_includes/gdi/available-gcp.rst
