v5.18.0/website/docs/r/logging_project_exclusion.html.markdown

---
subcategory: "Cloud (Stackdriver) Logging"
description: |-
  Manages a project-level logging exclusion.
---

# google\_logging\_project\_exclusion

Manages a project-level logging exclusion. For more information see:

* [API documentation](https://cloud.google.com/logging/docs/reference/v2/rest/v2/projects.exclusions)
* How-to Guides
    * [Excluding Logs](https://cloud.google.com/logging/docs/exclusions)

~> You can specify exclusions for log sinks created by terraform by using the exclusions field of `google_logging_project_sink`

## Example Usage

```hcl
resource "google_logging_project_exclusion" "my-exclusion" {
  name = "my-instance-debug-exclusion"

  description = "Exclude GCE instance debug logs"

  # Exclude all DEBUG or lower severity messages relating to instances
  filter = "resource.type = gce_instance AND severity <= DEBUG"
}
```

## Argument Reference

The following arguments are supported:

* `filter` - (Required) The filter to apply when excluding logs. Only log entries that match the filter are excluded.
    See [Advanced Log Filters](https://cloud.google.com/logging/docs/view/advanced-filters) for information on how to
    write a filter.

* `name` - (Required) The name of the logging exclusion.

* `description` - (Optional) A human-readable description.

* `disabled` - (Optional) Whether this exclusion rule should be disabled or not. This defaults to
    false.

* `project` - (Optional) The project to create the exclusion in. If omitted, the project associated with the provider is
    used.

## Attributes Reference

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

* `id` - an identifier for the resource with format `projects/{{project}}/exclusions/{{name}}`

## Import

Project-level logging exclusions can be imported using their URI, e.g.

* `projects/{{project_id}}/exclusions/{{name}}`

In Terraform v1.5.0 and later, use an [`import` block](https://developer.hashicorp.com/terraform/language/import) to import project-level logging exclusions using one of the formats above. For example:

```tf
import {
  id = "projects/{{project_id}}/exclusions/{{name}}"
  to = google_logging_project_exclusion.default
}
```

When using the [`terraform import` command](https://developer.hashicorp.com/terraform/cli/commands/import), project-level logging exclusions can be imported using one of the formats above. For example:

```
$ terraform import google_logging_project_exclusion.default projects/{{project_id}}/exclusions/{{name}}
```