# The Issue object

A quality or operational problem found in an experiment's traces.

## Attributes

- `name` (string, Beta, ID, Immutable)
  experiments/{experiment}/issues/{issue}
- `issue_id` (string, Beta, Output only)
  The last segment of `name`. Issue assessments on traces reference the Issue
   by this ID.
- `title` (string, Beta)
  Non-empty, at most 250 UTF-8 bytes.
- `description` (string, Beta)
  Markdown, at most 32 KiB.
- `status` (string, Beta)
  Defaults to PENDING on create, and can't be cleared.
  Possible values:
  - `PENDING`
  - `RESOLVED`
  - `REJECTED`
- `severity` (string, Beta)
  Cannot be cleared: an Issue without a severity would match no severity filter.
  Possible values:
  - `LOW`
  - `MEDIUM`
  - `HIGH`
- `categories` (array of string, Beta)
  At most 10 values of at most 64 UTF-8 bytes each, unique case-insensitively.
   Leading and trailing whitespace is trimmed.
- `tags` (object, Beta)
  Caller-owned; the server never writes system values here. At most 10
   entries. Keys match ^[A-Za-z0-9_.:/-]+$ and are at most 128 UTF-8 bytes;
   values are at most 256 UTF-8 bytes.
- `last_seen_time` (string, Beta)
  The request time of the latest trace the Issue affects. Required, and can't
   be cleared, unless source_type is MANUAL. A MANUAL Issue without one returns
   its create_time.
- `source_type` (string, Beta)
  Set once at create. Defaults to MANUAL.
  Possible values:
  - `ADHOC_RUN`
  - `SCHEDULED_RUN`
  - `SINGLE_TRACE_ANALYSIS`
  - `MANUAL`
- `source_id` (string, Beta)
  Set once at create. For ADHOC_RUN and SCHEDULED_RUN, the ID of the issue
   detection run in the same experiment that created the Issue. Absent for
   MANUAL.
- `created_by` (string, Beta, Output only)
  The email of the user whose request created the Issue. source_type tells
   whether issue detection created it.
- `create_time` (string, Beta, Output only)
  When the Issue was created.
- `last_updated_by` (string, Beta, Output only)
  The email of the user whose request last updated the Issue.
- `update_time` (string, Beta, Output only)
  When the Issue was last updated.
- `metadata` (object, Beta)
  Additional details about the Issue, such as how issue detection observed it.
   Not a stable contract: keys and values can change without notice, so clients
   must tolerate unknown and missing keys. At most 20 entries, with keys of at
   most 64 UTF-8 bytes.

## Example

```json
{
  "name": "string",
  "issue_id": "string",
  "title": "string",
  "description": "string",
  "status": "PENDING",
  "severity": "LOW",
  "categories": [
    "string"
  ],
  "tags": {},
  "last_seen_time": "string",
  "source_type": "ADHOC_RUN",
  "source_id": "string",
  "created_by": "string",
  "create_time": "string",
  "last_updated_by": "string",
  "update_time": "string",
  "metadata": {}
}
```