---
title: "aiomysql"
description: "Learn about importing the aiomysql integration and how it captures queries from aiomysql as spans."
url: https://docs.sentry.io/platforms/python/integrations/aiomysql/
---

# aiomysql | Sentry for Python

The aiomysql integration captures queries from [aiomysql](https://github.com/aio-libs/aiomysql/) as spans.

## [Install](https://docs.sentry.io/platforms/python/integrations/aiomysql.md#install)

Install `sentry-sdk` from PyPI:

```bash
pip install sentry-sdk
```

*Other available variations of the above snippet: uv*

## [Configure](https://docs.sentry.io/platforms/python/integrations/aiomysql.md#configure)

Add `AioMySQLIntegration()` to your `integrations` list:

```python
import sentry_sdk
from sentry_sdk.integrations.aiomysql import AioMySQLIntegration

sentry_sdk.init(
    dsn="https://<key>@o<orgId>.ingest.sentry.io/<projectId>",
    # Set traces_sample_rate to 1.0 to capture 100%
    # of transactions for tracing.
    traces_sample_rate=1.0,
    # Add data like inputs and responses;
    # see https://docs.sentry.io/platforms/python/data-management/data-collected/ for more info
    send_default_pii=True,
    integrations=[
        AioMySQLIntegration(),
    ],
)
```

## [Verify](https://docs.sentry.io/platforms/python/integrations/aiomysql.md#verify)

```python
import sentry_sdk
from sentry_sdk.integrations.aiomysql import AioMySQLIntegration
import aiomysql
import asyncio

sentry_sdk.init(
    dsn="https://<key>@o<orgId>.ingest.sentry.io/<projectId>",
    traces_sample_rate=1.0,
    send_default_pii=True,
    integrations=[
        AioMySQLIntegration(),
    ],
)

async def main():
    conn = await aiomysql.connect(
        host="localhost",
        port=3306,
        user="root",
        password="root",
        db="test",
    )
    try:
        with sentry_sdk.start_transaction(name="testing_sentry"):
            async with conn.cursor() as cur:
                await cur.execute("SELECT 'Hello World'")
                result = await cur.fetchone()
    finally:
        conn.close()
        
asyncio.run(main())
```

This will create a transaction called `testing_sentry` in the Performance section of [sentry.io](https://sentry.io) and will create a span for the `SELECT` statement.

It takes a couple of moments for the data to appear in [sentry.io](https://sentry.io).

## [Supported Versions](https://docs.sentry.io/platforms/python/integrations/aiomysql.md#supported-versions)

* aiomysql: 0.3+

The versions above apply for the current major version of the Python SDK. If you're looking to use Sentry with older Python or framework versions, consider using an older major version of the SDK.
