Troubleshooting Bots

Alation Cloud Service Applies to Alation Cloud Service instances of Alation

Customer Managed Applies to customer-managed instances of Alation

Logs

Bots stores logging information in a database. The logs are exposed in ASM alongside each Bot in the Bot dashboard. To view logs for a Bot:

  1. Login to your ASM machine.

  2. Click the Start button alongside Bots Automation or click Bots > Home in the left navigation.

  3. Select the Bot for which you want to view logs.

  4. Expand the Logs section. If the Bot has run at least once, the log will be displayed:

fde/static/fdeBotsLogging.png

You can download, copy or refresh the log using the buttons on the right-hand side.

Bot fails to run with “Cannot find policy” error

Check the Alation UI to confirm a Policy has been created for the Bot. Policies can be found in the Curate & Govern dashboard, or you can search. Create a policy if needed and try running the Bot again. Finally, cross-check the Bot’s policy with its configuration in ASM’s Bots Manager ensuring the names match.

Bot runs with unexpected result

If the incorrect objects are being scanned then try verifying the SQL query being used in Compose using the Alation Analytics data source.

Bot runs at unexpected times

In ASM’s Bot Manager, ensure the Bot’s “scheduled” toggle is enabled and double-check the cron string being used. To check your cron string enter it here. For examples of cron schedule expressions please refer to this page. For example, to run the Bot once daily at midnight use 0 0 * * *.

Bot exists in Bot manager but no corresponding Bot Policy exists

Bot Policies are typically automatically created when the Bot is set up in Bot Manager. But since Bot Violation policies are not always required, a Bot’s create_policy parameter can be configured as true to instruct the Bot to create a policy, or false to skip the policy creation.

This parameter exists because there may be scenarios when you just want your Bot to run and perform an action if a condition is met. For example, you may want to have a specific business policy attached to all your tables if the table is classified as containing PII data. The Bot will simply look for all tables marked with PII and automatically attach the business policy.

Bot fails validation

When creating a Bot and the validation fails due to a formatting or syntax error, try:

  1. Comparing the configuration with the sample Bots on our public GitHub page.

  2. Checking the parameters you’re using against the list of parameters on Configuring Bots to make sure they are valid.

Bot Notifications not working

If you have chosen a notification action for your Bot (conversation, email, Slack) ensure your Alation Services Manager (ASM) settings page has the settings correctly configured for your chosen notification method.