Billy Assistant in Cribl Stream
Ask Billy product questions and check the state of your deployment, without leaving the page you’re on.
About the Billy Assistant in Cribl Stream
In Cribl.Cloud, Billy opens in Cribl Stream as a sidebar that stays with you as you move between pages. On Cribl Stream pages, the sidebar replaces the Billy chatbot widget.
For how sessions, history, and availability work across Cribl products, see Billy Assistant.
What Billy Can Do
Answer product questions. Ask how a feature works, how to configure it, or how to troubleshoot a problem. These questions can cover Cribl Stream, Cribl Edge, Cribl Search, or Cribl Lake. Billy answers from the official documentation and includes links to the pages it cites.
Inspect your deployment. Ask about your current configuration and live status, and Billy reads it for you. It can read:
- Worker Groups and Fleets: Worker Groups, Edge Fleets, and deployment summaries.
- Sources and Destinations: Configuration, live I/O status, and persistent queue status.
- Routing and processing: Routes, Pipelines, Packs, Collectors, Event Breakers, Global Variables, and Lookups.
- System status: Health, system messages, processes, logger configuration, alert conditions, and Notification Policies.
- Cribl Search resources: Datasets, saved searches, Macros, and search engines.
- Cribl Lake resources: Lake Datasets, Lakehouses, Lake Sources, and storage locations.
Billy reads the Worker Group you’re viewing, and the Pack you’re viewing where one applies, unless you name another Worker Group. When it reports deployment data, Billy tells you which Worker Group or Pack it read, and it keeps information from the documentation separate from information about your deployment.
Troubleshoot problems. Describe an issue, and Billy combines the relevant documentation with the current state of your deployment to suggest next steps.
Write KQL. Describe what you want to find in your data, and Billy returns a KQL query you can run in Cribl Search. Billy doesn’t run the query.
Billy in Cribl Stream is read-only. It doesn’t create, change, or delete Sources, Destinations, Routes, Pipelines, or other configuration, and it doesn’t read the events flowing through Cribl Stream. To build Pipelines with AI assistance, use Pipeline Builder.
When Billy reads your configuration, it omits Global Variable values and credential fields, such as tokens, secrets, passwords, and private keys, before sending results to your AI provider.
MCP integrations aren’t available in the Cribl Stream sidebar.
Before You Start
- Use Cribl.Cloud. The sidebar isn’t available in on-prem deployments or in Cribl.Cloud Government.
- Confirm that an AI provider is configured for your Organization. See Cribl AI Availability.
Run a Billy Session
On the top bar, select the Billy icon at the upper right. The sidebar opens on the right side of the page, alongside your content. Select the icon again or select Close AI sidebar to close the sidebar.
A new session suggests example prompts that you can select, such as:
- Show my sources
- What destinations are in this worker group?
- Which pipelines are in this worker group?
- How do I mask a field in a pipeline?
For the sidebar header actions, session titles, and session history, see Sessions and History. Cribl products share one session history, so you can continue a conversation that you started in another product, such as Cribl Search.
How Permissions Apply
Billy acts as you. It reads your deployment through the same API calls that the UI makes for you, so it can only see what your existing permissions allow. If you can’t view a Worker Group or resource in the UI, Billy can’t read it either.
Other Cribl AI Features in Cribl Stream
- Pipeline Builder: Create and edit Pipelines with AI assistance.
- AWS Cloud Connections recommendations: Get suggested AWS log sources, Source configuration values, and a Destination.
For what each feature sends to an AI provider, see Cribl AI and Your Data.