debian-mirror-gitlab/doc/operations/incident_management/linked_resources.md

Ignoring revisions in .git-blame-ignore-revs. Click here to bypass and see the normal blame view.

99 lines
3.2 KiB
Markdown
Raw Normal View History

2022-08-27 11:52:29 +05:30
---
stage: Monitor
group: Respond
2022-11-25 23:54:43 +05:30
info: To determine the technical writer assigned to the Stage/Group associated with this page, see https://about.gitlab.com/handbook/product/ux/technical-writing/#assignments
2022-08-27 11:52:29 +05:30
---
# Linked resources in incidents **(PREMIUM)**
2023-01-13 00:05:48 +05:30
> - [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/230852) in GitLab 15.3 [with a flag](../../administration/feature_flags.md) named `incident_resource_links_widget`. Disabled by default.
> - [Enabled on GitLab.com](https://gitlab.com/gitlab-org/gitlab/-/issues/364755) in GitLab 15.3.
> - [Generally available](ihttps://gitlab.com/gitlab-org/gitlab/-/issues/364755) in GitLab 15.5. Feature flag `incident_resource_links_widget` removed.
2022-08-27 11:52:29 +05:30
To help your team members find the important links without having to search through many comments,
you can add linked resources to an incident issue.
Resources you might want link to:
2023-03-04 22:38:38 +05:30
- The incident Slack channel
- Zoom meeting
- Resources for resolving the incidents
2022-08-27 11:52:29 +05:30
## View linked resources of an incident
Linked resources for an incident are listed under the **Summary** tab.
![Linked resources list](img/linked_resources_list_v15_3.png)
To view the linked resources of an incident:
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Projects** and find your project.
2022-08-27 11:52:29 +05:30
1. On the left sidebar, select **Monitor > Incidents**.
1. Select an incident.
## Add a linked resource
Add a linked resource manually from an incident.
Prerequisites:
- You must have at least the Reporter role for the project.
To add a linked resource:
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Projects** and find your project.
2022-08-27 11:52:29 +05:30
1. On the left sidebar, select **Monitor > Incidents**.
1. Select an incident.
1. In the **Linked resources** section, select the plus icon (**{plus-square}**).
1. Complete the required fields.
1. Select **Add**.
2023-03-17 16:20:25 +05:30
### Using a quick action
2022-11-25 23:54:43 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/374964) in GitLab 15.5.
To add multiple links to an incident, use the `/link`
[quick action](../../user/project/quick_actions.md):
```plaintext
/link https://example.link.us/j/123456789
```
You can also submit a short description with the link.
The description shows instead of the URL in the **Linked resources** section of the incident:
```plaintext
2023-01-13 00:05:48 +05:30
/link https://example.link.us/j/123456789 multiple alerts firing
2022-11-25 23:54:43 +05:30
```
2023-03-17 16:20:25 +05:30
### Link Zoom meetings from an incident
2022-10-11 01:57:18 +05:30
> [Introduced](https://gitlab.com/gitlab-org/gitlab/-/issues/230853) in GitLab 15.4.
Use the `/zoom` [quick action](../../user/project/quick_actions.md) to add multiple Zoom links to an incident:
```plaintext
/zoom https://example.zoom.us/j/123456789
```
You can also submit a short optional description with the link. The description shows instead of the URL in the **Linked resources** section of the incident issue:
```plaintext
2022-11-25 23:54:43 +05:30
/zoom https://example.zoom.us/j/123456789 Low on memory incident
2022-10-11 01:57:18 +05:30
```
2022-08-27 11:52:29 +05:30
## Remove a linked resource
You can also remove a linked resource.
2022-10-11 01:57:18 +05:30
Prerequisites:
2022-08-27 11:52:29 +05:30
- You must have at least the Reporter role for the project.
To remove a linked resource:
2022-10-11 01:57:18 +05:30
1. On the top bar, select **Main menu > Projects** and find your project.
2022-08-27 11:52:29 +05:30
1. On the left sidebar, select **Monitor > Incidents**.
1. Select an incident.
1. In the **Linked resources** section, select **Remove** (**{close}**).