terraform-provider-google/website/docs/r/monitoring_group.html.markdown

layout	page_title	sidebar_current	description
google	Google: google_monitoring_group	docs-google-monitoring-group	The description of a dynamic collection of monitored resources.

google_monitoring_group

The description of a dynamic collection of monitored resources. Each group has a filter that is matched against monitored resources and their associated metadata. If a group's filter matches an available monitored resource, then that resource is a member of that group.

To get more information about Group, see:

• API documentation
• How-to Guides
  • Official Documentation

## Example Usage - Monitoring Group Basic

resource "google_monitoring_group" "basic" {
  display_name = "New Test Group"

  filter = "resource.metadata.region=\"europe-west2\""
}

## Example Usage - Monitoring Group Subgroup

resource "google_monitoring_group" "parent" {
  display_name = "New Test SubGroup"
  filter = "resource.metadata.region=\"europe-west2\""
}

resource "google_monitoring_group" "subgroup" {
  display_name = "New Test SubGroup"
  filter = "resource.metadata.region=\"europe-west2\""
  parent_name =  "${google_monitoring_group.parent.name}"
}

Argument Reference

The following arguments are supported:

• display_name - (Required) A user-assigned name for this group, used only for display purposes.

• filter - (Required) The filter used to determine which monitored resources belong to this group.

---

• parent_name - (Optional) The name of the group's parent, if it has one. The format is "projects/{project_id_or_number}/groups/{group_id}". For groups with no parent, parentName is the empty string, "".

• is_cluster - (Optional) If true, the members of this group are considered to be a cluster. The system can perform additional analysis on groups that are clusters.

• 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 - A unique identifier for this group. The format is "projects/{project_id_or_number}/groups/{group_id}".

Timeouts

This resource provides the following Timeouts configuration options:

• create - Default is 4 minutes.
• update - Default is 4 minutes.
• delete - Default is 4 minutes.

Import

Group can be imported using any of these accepted formats:

$ terraform import google_monitoring_group.default {{name}}

-> If you're importing a resource with beta features, make sure to include -provider=google-beta as an argument so that Terraform uses the correct provider to import your resource.