--- title: "Ansible AWX" slug: "ansible-awx" updated: 2025-07-01T15:48:50Z published: 2025-07-01T15:48:50Z canonical: "docs.databee.buzz/ansible-awx" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.databee.buzz/llms.txt > Use this file to discover all available pages before exploring further. # Ansible AWX Ansible AWX is a free, open-source automation platform that provides a web-based user interface, REST API, and task engine for managing Ansible automation workflows. It’s essentially the open-source equivalent of Ansible Tower, a commercial Ansible automation platform. For more information refer [Ansible AWX Documentation](https://ansible.readthedocs.io/projects/awx/en/latest/index.html). **Integration Method:** Data Collector (API Ingest) **Tables**: Account change (3001), Device Inventory (5001), Device Config State (5002), Group Management (3006), Scheduled Job Activity (1006) This integration supports the following events. | **Event** | **Description** | | --- | --- | | Activity Stream | Retrieves the list of all the activities performed. | This integration supports the following versions. | Ansible AWX Version | 24.6.0 | | --- | --- | | Ansible AWX API version | V2 | ## Prerequisites - The user should have access to the Ansible AWX portal with an account that has the Administrator privileges. - The user should have a [compatible version](https://docs.databee.buzz/docs/data-collector#prerequisites) of the system in which we can configure the data collector. For installation steps, please follow the [Data Collector configuration steps](https://docs.databee.buzz/docs/data-collector#configure-data-collector-in-databee). - The user should have access to the DataBee console. ## Configuration Overview 1. Configure the Data Collector. 2. Generate an [API token](/user-manual/docs/ansible-awx#ansible-awx-configuration) with the required scope. 3. Add the [Ansible AWX data feed](/user-manual/docs/ansible-awx#databee-configuration) in the DataBee console with the below parameters. | **DataBee Parameter** | **Ansible AWX Parameter** | | --- | --- | | Token | Token | | Base URL | http://: (e.g. http://x.x.x.x:9000) | ## Ansible AWX Configuration 1. On the top right corner, click on the **drop down** with your **username**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-q4gagv3t.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 2. In the dropdown menu, click **User Details**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-9zrttvm8.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 3. On the user details page, click **Tokens**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-owjnulvn.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 4. On the “Tokens” page, click **Add**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-4uco6evo.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 5. Fill in the required information in the **‘**Description’ field and select **Read** in ‘Scope’, then click **Save**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-afmn6uih.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 6. Click on the **copy** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-5ig04s5b.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) ## DataBee Configuration 1. Login to the DataBee UI, navigate to **Data** > **Data Feeds** and click the **Add New Data Feed** button. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-9ew1683f.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 2. Search for the **Ansible AWX** and click it as shown below. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-3ua8e26u.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 3. Click on the **Data Collector** option for collection method. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-bbwy49no.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 4. Select **API Ingest** as the polling mechanism. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-14fju6mx.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 5. Enter the feed contact information, select the collector which we have created previously and click **Next**. ![A screenshot of a computer AI-generated content may be incorrect.](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible-awx-onprem-api-image-0jls6vhs.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 6. In the configuration page, confirm the following: - **Base URL**: Paste the Base URL, including the port number, which would be the Ip address of the Ansible AWX Server. - **Event Types:** Preselected for all the event types that integration pulls. > [!NOTE] > **Note**: > > Limit is set to 500 requests/60s for a high-spec (8GB RAM) setup. Use 100 requests/60s for lower-spec setups. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible1.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 7. Paste the token generated and then click **Next**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible2.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) 8. Click **Submit**. ![](https://cdn.document360.io/04e48772-4346-44a4-aa69-043eca42257c/Images/Documentation/ansible3.png?sv=2026-02-06&spr=https&st=2026-10-30T11%3A37%3A51Z&se=2026-10-30T12%3A37%3A51Z&sr=c&sp=r&sig=%2FHZ3HkkkzAF%2FXN38ewDzA02YwH7Flvw8FMnduELAjFo%3D) ## Troubleshooting Tips - Ensure the token is pasted correctly. Since you cannot view the token after the 1st time, re-create the token, paste it on a text editor to ensure no spaces or unexpected characters are included and reconfigure the DataBee feed. - Ensure the Ansible AWX scopes/permissions are correct. #