Contextual Log Query Language (CLQL)
Last updated
Was this helpful?
Last updated
Was this helpful?
Available to users in tenants which are on subscription plans that support advanced Agent Log features, the Contextual Log Query Language (CLQL) is a powerful and flexible way to search, filter, and isolate the details you need across Agent Message Logs to gain insights into your tenant's activities.
To get started:
Go to Logs → All Logs in your tenant, which will default to the Messages tab
Enter your query in CLQL Query Editor in the top right of the screen and press Enter or click Search to perform your query
CLQL’s search syntax uses a pipeline concept. By default, CLQL:
Pulls all log messages from the last 24 hours for your tenant
Displays the most recent messages at the top
To narrow your search, add keywords and operators to refine your results until you find exactly what you need.
Inside the editor (Logs → All Logs - Message Tab), a typical search query looks like this:
Select a Time Range from the drop-down (defaults to “Last 24 hours”)
Enter a simple key term (e.g. error) to match any messages containing that term in any field value
Press Enter or click Search
Contextual returns all log messages matching your search query in the Messages tab below
Tip: All queries should begin with a string or keyword search. You can combine multiple searches with spaces. If your query gets long, use soft returns (line breaks) to make it more readable.
Dig into the details of String Searches, Keyword Searches, and Advanced Operators.
String SearchesKeyword SearchesAdvanced Operators