1. Start with the right place
OpenSearch Dashboards usually lets you search in Discover or inside a Dashboard.
- Use Discover when you want to inspect raw records or logs.
- Use Dashboards when you want to filter charts, tables, and visual panels.
OpenSearch Dashboards supports search using DQL, short for Dashboards Query Language, and also Lucene/query string syntax. DQL is usually easier for everyday dashboard filtering.
2. Set the time range first
Before searching, check the time picker, usually in the top-right corner.
Examples:
- Last 15 minutes
- Last 24 hours
- Last 7 days
- Custom date range
Many “missing data” problems are caused by the wrong time range.
3. Basic search examples
Search for a word
errorFinds records that contain "error".
Search a specific event rule ID
Add filter, select rule.id from the field drop down. Choose the 'operator' and the rule ID for 'value'
Most dashboards let you click values in charts or tables to add filters.
Example:
- Click a service name.
- Choose Filter for value.
- The dashboard refreshes using that filter.
This is often easier than typing a query manually and it is the recommended query method as you learn to use Inspector
Common useful searches
| Purpose | Search |
|---|---|
| High severity alerts | rule.level >= 10 |
| Critical alerts | rule.level >= 12 |
| Alerts from an agent | agent.name: "webserver01" |
| Alerts from an IP | data.srcip: "192.168.1.100" |
| Alerts for a user | data.user: "administrator" |
| SSH alerts | rule.groups: "sshd" |
| File integrity alerts | rule.groups: "syscheck" |
| Rootcheck alerts | rule.groups: "rootcheck" |
| Specific rule | rule.id: 5710 |
| Failed logins | rule.description: "failed" |
| Sudo Activity | rule.groups: "sudo" |
| Windows events | rule.groups: "windows" |
Troubleshooting
If your search returns no results, check these:
- Time range — Is it too narrow?
- Field name — Is the field spelled correctly?
- Value format — Does the value need quotes?
- Dashboard filters — Is another filter hiding results?
- Data source/index pattern — Are you searching the right data?
Best practices
- Set the time range first.
- Start broad, then narrow down.
- Use field searches instead of plain text when possible.
- Use quotes for values with spaces.
- Clear old filters before starting a new search.
- Save useful searches if your dashboard supports saved queries.