Grpc Attributes

13 attributes in this category.13 stable

13 attributes

Stable Attributes

grpc.error.bad_request.field_violations

string[]Scrub: ManualVisibility: PublicOTel: 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#460Added 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

stringScrub: AutoVisibility: PublicOTel: 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.

Exampleat com.example.Service.method(Service.java:42)
Changelog
v0.17.0#460Added 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: AutoVisibility: PublicOTel: 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#460Added 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

stringScrub: ManualVisibility: PublicOTel: False

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

Exampleexample.sentry.io
Changelog
v0.17.0#460Added 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>

stringScrub: AutoVisibility: PublicOTel: FalseDynamic

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.

Examplegrpc.error.error_info.metadata.user_id='123'
Dynamic SuffixYes - the key contains dynamic parts
Changelog
v0.17.0#460Added 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

stringScrub: ManualVisibility: PublicOTel: False

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

ExampleFIELD_INVALID
Changelog
v0.17.0#460Added 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: AutoVisibility: PublicOTel: 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#460Added 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: AutoVisibility: PublicOTel: 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#460Added 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

stringScrub: ManualVisibility: PublicOTel: False

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

ExampleInstance is not ready for the request.
Changelog
v0.17.0#460Added 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

stringScrub: AutoVisibility: PublicOTel: 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.

Exampleuser@example.com
Changelog
v0.17.0#460Added 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

stringScrub: AutoVisibility: PublicOTel: 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.

Exampleprojects/example/instances/example-instance
Changelog
v0.17.0#460Added 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

stringScrub: ManualVisibility: PublicOTel: False

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

Exampledatabase
Changelog
v0.17.0#460Added 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

integerScrub: ManualVisibility: PublicOTel: False

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

Example5000
Changelog
v0.17.0#460Added 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"
    }
  ]
}