Skip to content
NeuBird

IBM Cloud

Connecting Hawkeye to your IBM Cloud environment allows us to collect important telemetry data from various IBM Cloud services. Just like with other cloud providers, these include resource configurations, logs, events, and metrics.

The scope of data that we can access depends on the permissions assigned to the service access policy and the configuration of your IBM Cloud services.

For a secure connection, we’ll use an IBM Cloud API Key and Resource Group to grant Hawkeye the necessary permissions.

Step 1: Create an IBM Cloud Service ID and API Key

The following steps will guide you through the process of creating an IBM Cloud Service ID and API Key:

  1. Log in to IBM Cloud: Go to the IBM Cloud console and log in to your account.

  2. Navigate to IAM: From the IBM Cloud console, select Manage > Access (IAM) to access the IAM settings.

  3. Create a Service ID: Under Access (IAM), click on Service IDs, then select Create. Enter a name and description for the new Service ID, and click Create.

  4. Generate an API Key:

    • Select the Service ID you just created, and under API Keys, click on Create.
    • Give the API key a name and description, then click Create.

  5. Assign Access Permissions: After generating the API key, go to Access Policies and assign the necessary permissions to the Service ID. Use Reader or Viewer roles on the services from which you want to collect telemetry data, such as IBM Log Analysis or IBM Cloud Monitoring.

  6. Copy the API Key: Once the API key is created, copy it. You will need this key for the connection setup on the Hawkeye dashboard.

Step 2: Add IBM Cloud Connection to Hawkeye

With your API key ready, follow these steps to complete the connection in the Hawkeye dashboard.

  1. Navigate to the connections tab: On the Hawkeye dashboard, navigate to the Connections section and select the New Connection card.

  2. Select IBM Cloud connection: From the list of available connections, choose IBM Cloud.

  3. Enter credentials:

    • Name: Provide a name for the connection you’re creating.
    • Description: Give a brief description of the connection.
    • API Key: Paste the IBM Cloud API key you created in Step 1.
    • Resource Group: Select or enter the IBM Cloud Resource Group where your services are located.

  4. Save the connection: Once you verify that all credentials are correct, click the Save button.

  5. Confirm connection: If the connection is successful, you should see the IBM Cloud connection card displayed on the dashboard.