If you use Slack for office communication and workflows, Alice will fit right in.

Alice is a chatbot that lets you query your Logz.io data from Slack. This gives you a mobile-friendly way to work with Kibana and to share information without leaving your team’s chat.

For example, you can send a search or snapshot command to see the results in your conversation’s flow in real time.

You can ask Alice to search your logs, see triggerd alerts, and get visualization and dashboard snapshots.

Getting started with Alice

Set up Alice

Get an API token

If you’re a Logz.io account admin, get an API token for the account you want to add to Slack. Keep your API token handy—you’ll need to paste it in Slack later.

For Enterprise accounts

Create an API token in Logz.io. We recommend creating a token for use only with Alice.

For Pro accounts

Email help@logz.io to request an API token for Alice.

Add Alice to Slack

👇 If you’re an admin in your Slack workspace, go ahead and click this button to add Alice to Slack. Otherwise, ask an admin to do this step for you.

Add to Slack

When prompted, confirm Alice’s permissions.

Add an account to Slack

When you set up Alice for the first time, she’ll send a Slack message asking you if you want to add a new account. Click Add the account to continue.

Alice configuration

Choose your Account region (more on that here if you need help) and paste the API token from step 1.

Give the account an Alias that contains only letters, numbers, underscores, or dashes. You’ll use the account alias to tell Alice which account you want to interact with.

Users in your Slack workspace can use Alice to interact with your account, even if they don’t have access to Logz.io.

Click Save.

You can now ask Alice to help you with your Logz.io account and invite her to a specific channel—just remember to tag @Alice when you need something from her.

If you want to add another account, type @Alice add account.

To change Alice’s name

What if you have a coworker named Alice? Good news on this front—you can change Alice’s name in your Slack workspace. To do this, go to the app’s management page and click the edit pencil in the Bot User section.

After you change Alice’s name, @Alice won’t work anymore—you’ll need to use the new name you set. Make sure you communicate this change to all your Slack users so nobody feels offended that Alice is ignoring them.

Working with sub accounts

If you’re adding a few accounts to Alice, you can set default accounts per channel or for the whole Slack workspace—and you can override these settings by giving an alias in a command.

How does Alice know which account to use?

Alice looks for the account in this order:
Alias used in the commandChannel accountWorkspace account

Alias used in the command If you used an account alias in the command, Alice searches that account. This overrides the channel or workspace account settings.
Channel account If you didn’t use an alias in the command, Alice looks to see if there’s a default account for the channel you ran the command from.
Workspace account If there isn’t a channel account set, Alice uses the workspace account.

If you need help with how to write your commands, type @Alice help in Slack.