v5.18.0/website/docs/d/monitoring_cluster_istio_service.html.markdown

---
subcategory: "Cloud (Stackdriver) Monitoring"
description: |-
  An Monitoring Service resource created automatically by GCP to monitor an
  Cluster Istio service.
---

# google\_monitoring\_cluster\_istio\_service

A Monitoring Service is the root resource under which operational aspects of a
generic service are accessible. A service is some discrete, autonomous, and
network-accessible unit, designed to solve an individual concern

An Cluster Istio monitoring service is automatically created by GCP to monitor
Cluster Istio services.


To get more information about Service, see:

* [API documentation](https://cloud.google.com/monitoring/api/ref_v3/rest/v3/services)
* How-to Guides
    * [Service Monitoring](https://cloud.google.com/monitoring/service-monitoring)
    * [Monitoring API Documentation](https://cloud.google.com/monitoring/api/v3/)

## Example Usage - Monitoring Cluster Istio Service


```hcl
# Monitors the default ClusterIstio service
data "google_monitoring_cluster_istio_service" "default" {
        location = "us-west2-a"
        cluster_name = "west"
        service_namespace = "istio-system"
        service_name = "istio-policy"
}
```

## Argument Reference

The arguments of this data source act as filters for identifying a given -created service.

The given filters must match exactly one service whose data will be exported as attributes. The following arguments are supported:

The following fields must be specified:

* `location` - (Required) The location of the Kubernetes cluster in which this Istio service 
  is defined. Corresponds to the location resource label in k8s_cluster resources.

* `cluster_name` - (Required) The name of the Kubernetes cluster in which this Istio service 
  is defined. Corresponds to the clusterName resource label in k8s_cluster resources.

* `service_namespace` - (Required) The namespace of the Istio service underlying this service.
  Corresponds to the destination_service_namespace metric label in Istio metrics.

* `service_name` - (Required) The name of the Istio service underlying this service.
  Corresponds to the destination_service_name metric label in Istio metrics.
  
- - -

Other optional fields include:

* `project` - (Optional) The ID of the project in which the resource belongs.
    If it is not provided, the provider project is used.

## Attributes Reference

In addition to the arguments listed above, the following computed attributes are exported:

* `name` -
  The full REST resource name for this channel. The syntax is:
  `projects/[PROJECT_ID]/services/[SERVICE_ID]`.

* `display_name` -
  Name used for UI elements listing this (Monitoring) Service.

* `telemetry` -
  Configuration for how to query telemetry on the Service. Structure is documented below.

The `telemetry` block includes:

* `resource_name` -
  (Optional)
  The full name of the resource that defines this service.
  Formatted as described in
  https://cloud.google.com/apis/design/resource_names.