Integrations
Ops Desk ingests events from a variety of services that monitor resources. Referring to the illustration Typical Ops Desk topology, Ops Desk ingests events from PagerDuty, Travis CI, and server logs—all of which are monitoring three servers. To enable ingestion from services, you must integrate them with Ops Desk.
Adding an integration
This section describes how to integrate a most services into Ops Desk. For integrating an AWS service, see Adding an AWS integration.
Obtain or generate the credentials for the service you want to integrate. See the table Creating a service's credentials for Ops Desk access for guidelines.
In the left panel, click |mi-settings|.
Click Integrations. The Integrations widget appears.
For the service you want to integrate, do the following:
Under Available click |mi-add_circle|. An integration widget appears.
Enter the credentials you obtained in step 1.
Click Done.
Close the Integration widget.
The integration appears under Installed. You can now associate the integration with individual projects; for details, see Creating a project or Editing a project.
The following table provides the high-level steps for configuring the required Ops Desk permissions.
Service | Configuration guideline |
---|---|
Google Cloud | In the GCP console—
|
Azure | In the Azure console, or from the command line with the
|
Pingdom |
|
PagerDuty |
|
Travis CI | In the Travis CI console—
|
Slack | Obtain the bot token for the channel you want to monitor, and enter it in the New Slack Integration widget. |
Cloud Resources |
|
Adding an AWS integration
This section describes how to integrate an AWS service into Ops Desk. For integrating all other services, see Adding an integration.
In Ops Desk, do the following:
In the left panel, click |mi-settings|.
Click Integrations. The Integrations widget appears.
Under Available, in Amazon Web Services, click |mi-add_circle|. An integration widget appears.
In the Name field, enter a name for the integration.
From the Credentials list, select Aws Assume Role Credentials.
Copy the value in the field External ID into a text editor.
In the AWS Console, do the following:
Under IAM, click Roles.
Click Create role.
For the type of trusted entity, select Another AWS Account. The Specify accounts that can use this role widget appears.
In the Account ID field, enter
074158061309
.Mark Require external ID. An External ID field appears.
In the External ID field, paste the ID you copied in step 1.f, above.
Click Next.
Assign the role the permission AdministratorAccess.
Name the role
ops-desk
.Create the role.
Copy the account ID, region, and session duration into a text editor.
Returning to New Amazon Web Services Integration widget in Ops Desk, do the following:
In the Session Duration field, paste the session duration from step 2.k.
In the Credentials Region list, select the region from step 2.k.
In the Account ID field, paste the account ID from step 2.k.
In the Role Name field, enter
ops-desk
.Click Done.
Close the Integration widget.
The integration appears under Installed. You can now associate the integration with individual projects; for details, see Creating a project or Editing a project.
Modifying an integration
In the left panel, click |mi-settings|.
Click Integrations. The Integrations widget appears.
For the service you want to modify, do the following:
Under Installed, click |mi-more_horiz|, and then click Settings. An integration widget appears.
Modify the credentials as required. For information about creating a service's credentials, see the table Creating a service's credentials for Ops Desk access.
Click Done.
Close the Integration widget.
Disabling or deleting an integration
When you disable or delete an integration, Ops Desk no longer ingests events from the corresponding service.
In the left panel, click |mi-settings|.
Click Integrations. The Integrations widget appears.
For the service you want to disable or delete, do the following:
Click |mi-more_horiz|.
Select Disable or Delete.