Grpc Attributes

13 attributes in this category. 13 stable

13 attributes

Stable Attributes

grpc.error.bad_request.field_violations

string[] Scrub: Manual Visibility: Public OTel: False

The individual field violations from a google.rpc.BadRequest error detail. Each entry is a JSON-encoded object with field, description, reason, and (optional) localized_message keys, mirroring google.rpc.BadRequest.FieldViolation.

Example ["{\"field\":\"email\",\"description\":\"must be a valid email address\",\"reason\":\"FIELD_INVALID\",\"localized_message\":{\"locale\":\"en-US\",\"message\":\"Must be a valid email address\"}}"]
Changelog
v0.17.0 #460 Added grpc.error.bad_request.field_violations attribute
Raw JSON
{
  "key": "grpc.error.bad_request.field_violations",
  "brief": "The individual field violations from a google.rpc.BadRequest error detail. Each entry is a JSON-encoded object with field, description, reason, and (optional) localized_message keys, mirroring google.rpc.BadRequest.FieldViolation.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "{\"field\":\"email\",\"description\":\"must be a valid email address\",\"reason\":\"FIELD_INVALID\",\"localized_message\":{\"locale\":\"en-US\",\"message\":\"Must be a valid email address\"}}"
  ],
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.bad_request.field_violations attribute"
    }
  ]
}

grpc.error.debug_info.detail

string Scrub: Auto Visibility: Public OTel: False

Additional debugging information, such as a server-side stack trace, from a google.rpc.DebugInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.

Example at com.example.Service.method(Service.java:42)
Changelog
v0.17.0 #460 Added grpc.error.debug_info.detail attribute
Raw JSON
{
  "key": "grpc.error.debug_info.detail",
  "brief": "Additional debugging information, such as a server-side stack trace, from a google.rpc.DebugInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.",
  "type": "string",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "at com.example.Service.method(Service.java:42)",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.debug_info.detail attribute"
    }
  ]
}

grpc.error.debug_info.stack_entries

string[] Scrub: Auto Visibility: Public OTel: False

The server-side stack trace entries from a google.rpc.DebugInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.

Example ["com.example.Service.method(Service.java:42)","com.example.Server.handle(Server.java:100)"]
Changelog
v0.17.0 #460 Added grpc.error.debug_info.stack_entries attribute
Raw JSON
{
  "key": "grpc.error.debug_info.stack_entries",
  "brief": "The server-side stack trace entries from a google.rpc.DebugInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "com.example.Service.method(Service.java:42)",
    "com.example.Server.handle(Server.java:100)"
  ],
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.debug_info.stack_entries attribute"
    }
  ]
}

grpc.error.error_info.domain

string Scrub: Manual Visibility: Public OTel: False

The logical grouping to which the gRPC error reason belongs, from the google.rpc.ErrorInfo error detail.

Example example.sentry.io
Changelog
v0.17.0 #460 Added grpc.error.error_info.domain attribute
Raw JSON
{
  "key": "grpc.error.error_info.domain",
  "brief": "The logical grouping to which the gRPC error reason belongs, from the google.rpc.ErrorInfo error detail.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "example.sentry.io",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.error_info.domain attribute"
    }
  ]
}

grpc.error.error_info.metadata.<key>

string Scrub: Auto Visibility: Public OTel: False Dynamic

Additional structured metadata attached to a google.rpc.ErrorInfo error detail, with <key> being the metadata key name. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.

Example grpc.error.error_info.metadata.user_id='123'
Dynamic Suffix Yes - the key contains dynamic parts
Changelog
v0.17.0 #460 Added grpc.error.error_info.metadata.<key> attribute
Raw JSON
{
  "key": "grpc.error.error_info.metadata.<key>",
  "brief": "Additional structured metadata attached to a google.rpc.ErrorInfo error detail, with <key> being the metadata key name. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.",
  "has_dynamic_suffix": true,
  "type": "string",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "grpc.error.error_info.metadata.user_id='123'",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.error_info.metadata.<key> attribute"
    }
  ]
}

grpc.error.error_info.reason

string Scrub: Manual Visibility: Public OTel: False

The reason for the gRPC error, as defined by the service that generated it, from the google.rpc.ErrorInfo error detail.

Example FIELD_INVALID
Changelog
v0.17.0 #460 Added grpc.error.error_info.reason attribute
Raw JSON
{
  "key": "grpc.error.error_info.reason",
  "brief": "The reason for the gRPC error, as defined by the service that generated it, from the google.rpc.ErrorInfo error detail.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "FIELD_INVALID",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.error_info.reason attribute"
    }
  ]
}

grpc.error.precondition_failure.violations

string[] Scrub: Auto Visibility: Public OTel: False

The individual precondition violations from a google.rpc.PreconditionFailure error detail. Each entry is a JSON-encoded object with type, subject, and description keys. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly, since violation subjects may identify specific resources or users.

Example ["{\"type\":\"TOS\",\"subject\":\"example.com/user/123\",\"description\":\"User must accept the terms of service\"}"]
Changelog
v0.17.0 #460 Added grpc.error.precondition_failure.violations attribute
Raw JSON
{
  "key": "grpc.error.precondition_failure.violations",
  "brief": "The individual precondition violations from a google.rpc.PreconditionFailure error detail. Each entry is a JSON-encoded object with type, subject, and description keys. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly, since violation subjects may identify specific resources or users.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "{\"type\":\"TOS\",\"subject\":\"example.com/user/123\",\"description\":\"User must accept the terms of service\"}"
  ],
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.precondition_failure.violations attribute"
    }
  ]
}

grpc.error.quota_failure.violations

string[] Scrub: Auto Visibility: Public OTel: False

The individual quota violations from a google.rpc.QuotaFailure error detail. Each entry is a JSON-encoded object with subject, description, api_service, quota_metric, quota_id, quota_dimensions, quota_value, and (optional) future_quota_value keys, mirroring google.rpc.QuotaFailure.Violation. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly, since violation subjects may identify specific resources or users.

Example ["{\"subject\":\"clientip:127.0.0.1\",\"description\":\"Limit checks failed.\",\"api_service\":\"example.googleapis.com\",\"quota_metric\":\"example.googleapis.com/read_requests\",\"quota_id\":\"ReadRequestsPerMinutePerProject\",\"quota_dimensions\":{\"region\":\"us-central1\"},\"quota_value\":1000}"]
Changelog
v0.17.0 #460 Added grpc.error.quota_failure.violations attribute
Raw JSON
{
  "key": "grpc.error.quota_failure.violations",
  "brief": "The individual quota violations from a google.rpc.QuotaFailure error detail. Each entry is a JSON-encoded object with subject, description, api_service, quota_metric, quota_id, quota_dimensions, quota_value, and (optional) future_quota_value keys, mirroring google.rpc.QuotaFailure.Violation. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly, since violation subjects may identify specific resources or users.",
  "type": "string[]",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": [
    "{\"subject\":\"clientip:127.0.0.1\",\"description\":\"Limit checks failed.\",\"api_service\":\"example.googleapis.com\",\"quota_metric\":\"example.googleapis.com/read_requests\",\"quota_id\":\"ReadRequestsPerMinutePerProject\",\"quota_dimensions\":{\"region\":\"us-central1\"},\"quota_value\":1000}"
  ],
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.quota_failure.violations attribute"
    }
  ]
}

grpc.error.resource_info.description

string Scrub: Manual Visibility: Public OTel: False

A description of the error that occurred while accessing the resource, from a google.rpc.ResourceInfo error detail.

Example Instance is not ready for the request.
Changelog
v0.17.0 #460 Added grpc.error.resource_info.description attribute
Raw JSON
{
  "key": "grpc.error.resource_info.description",
  "brief": "A description of the error that occurred while accessing the resource, from a google.rpc.ResourceInfo error detail.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "Instance is not ready for the request.",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.resource_info.description attribute"
    }
  ]
}

grpc.error.resource_info.owner

string Scrub: Auto Visibility: Public OTel: False

The owner of the resource being accessed (e.g. project or account owning it), from a google.rpc.ResourceInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.

Example user@example.com
Changelog
v0.17.0 #460 Added grpc.error.resource_info.owner attribute
Raw JSON
{
  "key": "grpc.error.resource_info.owner",
  "brief": "The owner of the resource being accessed (e.g. project or account owning it), from a google.rpc.ResourceInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.",
  "type": "string",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "user@example.com",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.resource_info.owner attribute"
    }
  ]
}

grpc.error.resource_info.resource_name

string Scrub: Auto Visibility: Public OTel: False

The name of the resource being accessed, from a google.rpc.ResourceInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.

Example projects/example/instances/example-instance
Changelog
v0.17.0 #460 Added grpc.error.resource_info.resource_name attribute
Raw JSON
{
  "key": "grpc.error.resource_info.resource_name",
  "brief": "The name of the resource being accessed, from a google.rpc.ResourceInfo error detail. SDKs should only send this attribute when sendDefaultPii is enabled or dataCollection is configured accordingly.",
  "type": "string",
  "apply_scrubbing": {
    "key": "auto"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "projects/example/instances/example-instance",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.resource_info.resource_name attribute"
    }
  ]
}

grpc.error.resource_info.resource_type

string Scrub: Manual Visibility: Public OTel: False

The type of resource being accessed, from a google.rpc.ResourceInfo error detail.

Example database
Changelog
v0.17.0 #460 Added grpc.error.resource_info.resource_type attribute
Raw JSON
{
  "key": "grpc.error.resource_info.resource_type",
  "brief": "The type of resource being accessed, from a google.rpc.ResourceInfo error detail.",
  "type": "string",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": "database",
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.resource_info.resource_type attribute"
    }
  ]
}

grpc.error.retry_info.retry_delay_ms

integer Scrub: Manual Visibility: Public OTel: False

How long the client should wait before retrying the gRPC call, in milliseconds, from the google.rpc.RetryInfo error detail.

Example 5000
Changelog
v0.17.0 #460 Added grpc.error.retry_info.retry_delay_ms attribute
Raw JSON
{
  "key": "grpc.error.retry_info.retry_delay_ms",
  "brief": "How long the client should wait before retrying the gRPC call, in milliseconds, from the google.rpc.RetryInfo error detail.",
  "type": "integer",
  "apply_scrubbing": {
    "key": "manual"
  },
  "is_in_otel": false,
  "visibility": "public",
  "example": 5000,
  "changelog": [
    {
      "version": "0.17.0",
      "prs": [
        460
      ],
      "description": "Added grpc.error.retry_info.retry_delay_ms attribute"
    }
  ]
}