Diagnose issues by using the VPC Service Controls troubleshooter

This page describes how you can use the VPC Service Controls troubleshooter to understand and diagnose issues that VPC Service Controls logs.

VPC Service Controls logs include details about requests to protected resources and the reason why VPC Service Controls denied the request. However, these details aren't always easily apparent and you might spend considerable time understanding the logs. You can use the VPC Service Controls troubleshooter to diagnose denials from a service perimeter. For information on violation reasons, see Debugging requests blocked by VPC Service Controls .

You can also use the troubleshooter to diagnose denials from a service perimeter that uses a dry-run configuration.

Before you begin

To troubleshoot a VPC Service Controls violation, make sure that you have the VPC Service Controls Troubleshooter Viewer IAM role ( roles/accesscontextmanager.vpcScTroubleshooterViewer ) at the organization level. This role doesn't let you modify perimeters or access levels.

Accessing the VPC Service Controls troubleshooter

The troubleshooter is available only in the Google Cloud console. You can access the troubleshooter using either the Logs Explorer or the VPC Service Controls page.

Using the Logs Explorer

By using the Logs Explorer , you can move directly from a log entry for a VPC Service Controls denial to the troubleshooter.

To access the troubleshooter from a log entry, do the following:

1. Go to the Logs Explorerpage in the Google Cloud console.

   Go to Logs Explorer

2. In the Logs Explorer, use the denial's unique ID to access the log entry .

3. In the Query Resultsbox, in the row for the denial that you want to troubleshoot, click VPC Service Controls, and then click Troubleshoot denial.

Using the VPC Service Controls page

From the VPC Service Controlspage, you can troubleshoot a denial using its unique ID.

Before you begin, obtain the unique ID for the denial that you want to troubleshoot.

To access the troubleshooter from the VPC Service Controlspage, do the following:

1. In the Google Cloud console navigation menu, click Security, and then click VPC Service Controls.

   Go to VPC Service Controls

2. If you are prompted, select your organization. You can access the VPC Service Controlspage only at the organization level.

3. On the VPC Service Controlspage, click Troubleshoot.

4. On the VPC Service Controls Troubleshooterpage, in the Unique identifierbox, enter the unique ID for the denial that you want to troubleshoot.

5. Click Troubleshoot.

What's next

• Understanding VPC Service Controls audit logs
• Learn how VPC Service Controls unique identifier helps troubleshoot issues related to service perimeters .
• Diagnose an access denial event using the VPC Service Controls violation analyzer ( Preview ).