issues
Creates, updates, deletes, gets or lists an issues resource.
Overview
| Name | issues |
| Type | Resource |
| Id | firebase.firebasecrashlytics.issues |
Fields
The following fields are returned by SELECT queries:
- get
| Name | Datatype | Description |
|---|---|---|
id | string | Output only. Immutable. Unique identifier for the issue. |
name | string | Required. Output only. Immutable. Identifier. The name of the issue resource. Format: "projects/{project}/apps/{app}/issues/{issue}". |
errorType | string | Output only. Immutable. Indicates whether this issue is a crash, non-fatal exception, or ANR. (ERROR_TYPE_UNSPECIFIED, FATAL, NON_FATAL, ANR) |
firstSeenTime | string (google-datetime) | Output only. Immutable. The first time this issue was seen. |
firstSeenVersion | string | Output only. Immutable. The first app display_version in which this issue was seen, populated for mobile issues only. |
lastSeenTime | string (google-datetime) | Output only. The most recent time this issue was seen. |
lastSeenVersion | string | Output only. The most recent app display_version in which this issue was seen, populated for mobile issues only. |
notesCount | string (int64) | Output only. The number of notes attached to an issue. |
sampleEvent | string | Output only. The resource name for a sample event in this issue. |
signals | array | Output only. Immutable. Distinctive characteristics assigned by the Crashlytics analyzer. |
state | string | Output only. Indicates whether this issue is open, closed or muted. For details on how issue states change without user actions, see Regressed Issues. (STATE_UNSPECIFIED, OPEN, CLOSED, MUTED) |
stateUpdateTime | string (google-datetime) | Output only. The time at which the issue state was last changed. |
subtitle | string | Output only. Immutable. Caption subtitle. This is usually a symbol or an exception message. |
title | string | Output only. Immutable. Caption title. This is usually a source file or method name. |
uri | string | Output only. Provides a link to the Issue on the Firebase console. When this Issue is obtained as part of a Report, then the link will be configured with the same time interval and filters as the request. |
variants | array | Output only. Immutable. The top 12 variants (subgroups) within the issue. Variants group events within an issue that are very similar. A single result implies that the variant is the same as the parent issue. This field will be empty when multiple issues are requested. Request a single issue to list variants. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get | select | projectsId, appsId, issuesId | Retrieve an issue. | |
patch | update | projectsId, appsId, issuesId | updateMask | Change the state of an issue. |
batch_update | update | projectsId, appsId | Change the state of a group of issues. This method is not atomic, so partial failures can occur. In the event of a partial failure, the request will fail and you will need to call GetIssue to see which issues were not updated. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
appsId | string | |
issuesId | string | |
projectsId | string | |
updateMask | string (google-fieldmask) |
SELECT examples
- get
Retrieve an issue.
SELECT
id,
name,
errorType,
firstSeenTime,
firstSeenVersion,
lastSeenTime,
lastSeenVersion,
notesCount,
sampleEvent,
signals,
state,
stateUpdateTime,
subtitle,
title,
uri,
variants
FROM firebase.firebasecrashlytics.issues
WHERE projectsId = '{{ projectsId }}' -- required
AND appsId = '{{ appsId }}' -- required
AND issuesId = '{{ issuesId }}' -- required
;
UPDATE examples
- patch
- batch_update
Change the state of an issue.
UPDATE firebase.firebasecrashlytics.issues
SET
-- No updatable properties
WHERE
projectsId = '{{ projectsId }}' --required
AND appsId = '{{ appsId }}' --required
AND issuesId = '{{ issuesId }}' --required
AND updateMask = '{{ updateMask}}'
RETURNING
id,
name,
errorType,
firstSeenTime,
firstSeenVersion,
lastSeenTime,
lastSeenVersion,
notesCount,
sampleEvent,
signals,
state,
stateUpdateTime,
subtitle,
title,
uri,
variants;
Change the state of a group of issues. This method is not atomic, so partial failures can occur. In the event of a partial failure, the request will fail and you will need to call GetIssue to see which issues were not updated.
UPDATE firebase.firebasecrashlytics.issues
SET
data__requests = '{{ requests }}',
data__updateMask = '{{ updateMask }}'
WHERE
projectsId = '{{ projectsId }}' --required
AND appsId = '{{ appsId }}' --required
RETURNING
issues;