Functions Reference
This guide covers functions available for querying array fields in SigNoz.
Note: Functions are currently supported only for JSON body searches.
Available Functions
has() Function
Checks if an array contains a specific value.
Syntax:
has(field, value)
Examples:
has(body.user_ids, 123)
has(body.tags, 'production')
has(body.regions, 'us-east')
Important Notes
- Body fields only - Functions currently work only with JSON body fields (fields prefixed with
body.) - Array data - The field must contain an array for these functions to work properly
Combining with Other Conditions
Functions can be combined with other query conditions:
# Find production logs with error status codes
has(body.tags, 'production') AND status_code IN [500, 502, 503]
Common Use Cases
Filtering by Tags
# Find all logs with production tag
has(body.tags, 'production')
## Error Messages
Common errors you might encounter:
- **"unknown function"** - Check function name spelling and case
- **"function expects key and value parameters"** - Ensure you're providing both field and value
- **"function supports only body JSON search"** - Use only with `body.` prefixed fields
Last updated: July 31, 2025
Edit on GitHub
