This page lists the IAM roles and permissions for Telemetry API. To
search through all roles and permissions, see the [role and
permission index](https://docs.cloud.google.com/iam/docs/roles-permissions).

## Telemetry API roles

| Role | Permissions |
|---|---|
| #### Telemetry Admin (`roles/telemetry.admin`) Admin role for telemetry | `resourcemanager.projects.get` `resourcemanager.projects.list` `telemetry.*` - `telemetry.consumers.getIamPolicy` - `telemetry.consumers.setIamPolicy` - `telemetry.consumers.writeLogs` - `telemetry.consumers.writeMetrics` - `telemetry.consumers.writeTraces` - `telemetry.traces.write` |
| #### Telemetry Editor (`roles/telemetry.editor`) Editor role for telemetry | `resourcemanager.projects.get` `resourcemanager.projects.list` `telemetry.traces.write` |
| #### Consumer Admin ^Beta^ (`roles/telemetry.consumerAdmin`) Grants permission management access to consumer resources. | `telemetry.consumers.getIamPolicy` `telemetry.consumers.setIamPolicy` |
| #### Cloud Telemetry Logs Writer (`roles/telemetry.logsWriter`) Access to write logs. | `logging.logEntries.create` |
| #### Cloud Telemetry Metrics Writer (`roles/telemetry.metricsWriter`) Access to write metrics. | `monitoring.timeSeries.create` |
| #### Integrated Service Telemetry Logs Writer ^Beta^ (`roles/telemetry.serviceLogsWriter`) Allows an onboarded service to write log data to a destination. | `telemetry.consumers.writeLogs` |
| #### Integrated Service Telemetry Metrics Writer ^Beta^ (`roles/telemetry.serviceMetricsWriter`) Allows an onboarded service to write metrics data to a destination. | `telemetry.consumers.writeMetrics` |
| #### Integrated Service Telemetry Writer ^Beta^ (`roles/telemetry.serviceTelemetryWriter`) Allows an onboarded service to write all telemetry data to a destination. | `telemetry.consumers.writeLogs` `telemetry.consumers.writeMetrics` `telemetry.consumers.writeTraces` |
| #### Integrated Service Telemetry Traces Writer ^Beta^ (`roles/telemetry.serviceTracesWriter`) Allows an onboarded service to write trace data to a destination. | `telemetry.consumers.writeTraces` |
| #### Cloud Telemetry Traces Writer (`roles/telemetry.tracesWriter`) Access to write trace spans. | `telemetry.traces.write` |
| #### Cloud Telemetry Writer (`roles/telemetry.writer`) Full access to write all telemetry data. | `logging.logEntries.create` `monitoring.timeSeries.create` `telemetry.traces.write` |

## Telemetry API permissions

| Permission | Included in roles |
|---|---|
| #### `telemetry.consumers.getIamPolicy` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Security Reviewer](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityReviewer) (`roles/iam.securityReviewer`) [Telemetry Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.admin) (`roles/telemetry.admin`) [Security Auditor](https://docs.cloud.google.com/iam/docs/roles-permissions/jobfunctions.md.txt#iam.securityAuditor) (`roles/iam.securityAuditor`) [Consumer Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.consumerAdmin) (`roles/telemetry.consumerAdmin`) |
| #### `telemetry.consumers.setIamPolicy` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Security Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/iam.md.txt#iam.securityAdmin) (`roles/iam.securityAdmin`) [Telemetry Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.admin) (`roles/telemetry.admin`) [Consumer Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.consumerAdmin) (`roles/telemetry.consumerAdmin`) |
| #### `telemetry.consumers.writeLogs` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Telemetry Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.admin) (`roles/telemetry.admin`) [Integrated Service Telemetry Logs Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.serviceLogsWriter) (`roles/telemetry.serviceLogsWriter`) [Integrated Service Telemetry Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.serviceTelemetryWriter) (`roles/telemetry.serviceTelemetryWriter`) |
| #### `telemetry.consumers.writeMetrics` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Telemetry Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.admin) (`roles/telemetry.admin`) [Integrated Service Telemetry Metrics Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.serviceMetricsWriter) (`roles/telemetry.serviceMetricsWriter`) [Integrated Service Telemetry Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.serviceTelemetryWriter) (`roles/telemetry.serviceTelemetryWriter`) |
| #### `telemetry.consumers.writeTraces` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Telemetry Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.admin) (`roles/telemetry.admin`) [Integrated Service Telemetry Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.serviceTelemetryWriter) (`roles/telemetry.serviceTelemetryWriter`) [Integrated Service Telemetry Traces Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.serviceTracesWriter) (`roles/telemetry.serviceTracesWriter`) |
| #### `telemetry.traces.write` | [Admin](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/admin`) [Owner (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/owner`) [Writer](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/writer`) [Editor (Legacy)](https://docs.cloud.google.com/iam/docs/roles-overview.md.txt#basic) (`roles/editor`) [Cloud Trace Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudtrace.md.txt#cloudtrace.admin) (`roles/cloudtrace.admin`) [Telemetry Admin](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.admin) (`roles/telemetry.admin`) [Telemetry Editor](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.editor) (`roles/telemetry.editor`) [Cloud Trace Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/cloudtrace.md.txt#cloudtrace.agent) (`roles/cloudtrace.agent`) [Firebase App Hosting Compute Runner](https://docs.cloud.google.com/iam/docs/roles-permissions/firebaseapphosting.md.txt#firebaseapphosting.computeRunner) (`roles/firebaseapphosting.computeRunner`) [Cloud Telemetry Traces Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.tracesWriter) (`roles/telemetry.tracesWriter`) [Cloud Telemetry Writer](https://docs.cloud.google.com/iam/docs/roles-permissions/telemetry.md.txt#telemetry.writer) (`roles/telemetry.writer`) Service agent roles > [!WARNING] > **Warning:** Don't grant service agent roles to any principals except [service agents](https://docs.cloud.google.com/iam/docs/service-agents.md.txt). - [Vertex AI Reasoning Engine Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/aiplatform.md.txt#aiplatform.reasoningEngineServiceAgent) (`roles/aiplatform.reasoningEngineServiceAgent`) - [Apigee Core Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/apigee.md.txt#apigee.coreServiceAgent) (`roles/apigee.coreServiceAgent`) - [Apigee Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/apigee.md.txt#apigee.serviceAgent) (`roles/apigee.serviceAgent`) - [Kubernetes Engine Default Node Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/container.md.txt#container.defaultNodeServiceAgent) (`roles/container.defaultNodeServiceAgent`) - [Database Insights Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/databaseinsights.md.txt#databaseinsights.serviceAgent) (`roles/databaseinsights.serviceAgent`) - [Firebase AI Logic Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/firebaseml.md.txt#firebaseml.serviceAgent) (`roles/firebaseml.serviceAgent`) - [Firebase Telemetry Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/firebasetelemetry.md.txt#firebasetelemetry.serviceAgent) (`roles/firebasetelemetry.serviceAgent`) - [Mesh Data Plane Service Agent](https://docs.cloud.google.com/iam/docs/roles-permissions/anthosservicemesh.md.txt#meshdataplane.serviceAgent) (`roles/meshdataplane.serviceAgent`) |