> ## Documentation Index
> Fetch the complete documentation index at: https://semgrep-ee9d73d8-mintlify-b75b9a88.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# View runtime context from Sysdig

> The Semgrep Sysdig integration can ingest runtime context from your Sysdig account into Semgrep AppSec Platform. This allows you to prioritize findings based on deployment status.

## Prerequisites

Before proceeding, ensure that:

* You have a license for **Semgrep Supply Chain**
* You have the following tools and integrations set up in your Sysdig account:
  * [<Icon icon="external-link" iconType="solid" /> Sysdig Secure](https://docs.sysdig.com/en/sysdig-secure/)
  * [<Icon icon="external-link" iconType="solid" /> Sysdig Shield](https://docs.sysdig.com/en/sysdig-secure/install-shield-kubernetes/), [<Icon icon="external-link" iconType="solid" /> Host Shield](https://docs.sysdig.com/en/sysdig-secure/install-host-shield/), or [<Icon icon="external-link" iconType="solid" /> Agentless Scanning](https://docs.sysdig.com/en/sysdig-secure/scanning-usecases/#agentless-host-scanning-tech-preview)
  * The [<Icon icon="external-link" iconType="solid" /> Semgrep Sysdig integration](https://docs.sysdig.com/en/sysdig-secure/integrations-for-sysdig-secure/software-composition-analysis/#semgrep)
    * Ensure that you've [<Icon icon="external-link" iconType="solid" /> completed the steps to link source to runtime by adding a Docker label](https://docs.sysdig.com/en/sysdig-secure/integrations-for-sysdig-secure/software-composition-analysis/#prerequisite-linking-source-to-runtime)
* You have set up a connection between [Semgrep and your source code manager (SCM)](/deployment/connect-scm).

## Enable the Sysdig integration

<Steps>
  <Step>
    Sign in to [Semgrep AppSec Platform](https://semgrep.dev/login).
  </Step>

  <Step>
    Navigate to [**Settings > Integrations**](https://semgrep.dev/orgs/-/settings/integrations).
  </Step>

  <Step>
    Click **+ Add > Sysdig**.
  </Step>

  <Step>
    In the dialog that appears, provide the following information:

    i. **URL**: The Sysdig Platform URL for your account.

    ii. **API token**: The Sysdig API token associated with your account. See [<Icon icon="external-link" iconType="solid" /> Retrieve the Sysdig API Token](https://docs.sysdig.com/en/administration/retrieve-the-sysdig-api-token/) for more information on how to retrieve your token.
  </Step>

  <Step>
    Click **Connect**.
  </Step>

  <Step>
    Within several hours, you should see the **Deployment** status for each project on the project's settings page.
  </Step>
</Steps>

## Limitations

* Each Semgrep deployment can only have **one Sysdig integration**.
* The runtime context data is only synced for Semgrep projects that:
  * Are connected to SCMs
  * Have been scanned within the previous 30 days
  * Have Supply Chain findings
* The integration syncs your data every 24 hours, but it may take up to 1 day for Semgrep to reflect any changes to your repositories and infrastructure.

## Troubleshooting

### If you see a **Connection Error** message under your Sysdig integration

If you see the **Connection Error** message under your Sysdig integration, there was an issue establishing a connection or running a sync job for a provider you have connected. Check your connection settings to verify that your configuration is correct.

If the connection settings are correct, [contact Support](/support) for further assistance.

### If you're not seeing data in your project settings page

If you're not seeing data for your project in the project settings page:

* Wait for one day for your data to sync.
* Confirm that an image of the project has been deployed in your infrastructure that Sysdig has access to
* If, after one day, you're still not seeing data, ensure that you meet the integration's prerequisites.
* If, after one day, you meet the integration's prerequisites and confirmed deployment, [contact Support](/support) for further assistance.
