Skip to main content

Endpoint

GET /v1/logs/search

Query Parameters

Searchable Fields

  • message - Log message (default)
  • errorName - Error class/name
  • errorStack - Error stack trace
  • data - JSON data field

Search Syntax

Simple word search (case-insensitive):

Multiple Terms (AND)

All terms must be present:
Match exact phrase:
Match any of the terms:

Exclude Terms

Exclude logs containing a term:

Combined

Response

Examples

Basic Search

Search Specific Fields

Phrase Search

Exclude Terms

Combined Filters

Time Range

Error Responses

401 Unauthorized - Invalid or missing API key
How to resolve: Ensure your Authorization or X-API-Key header is included and valid. See Authentication for details. 400 Bad Request - Invalid query
How to resolve: The q parameter must be at least 2 characters long. Provide a longer search query. 500 Internal Server Error:
How to resolve: Retry the request. If the error persists, try simplifying the query or reducing the number of search fields.

Search Tips

  1. Start specific - Use specific terms to narrow results
  2. Use phrases - Wrap multi-word searches in quotes for exact matches
  3. Exclude noise - Use -term to filter out irrelevant results
  4. Search errors - Add errorStack to fields when debugging exceptions
  5. Combine with filters - Use level=error to focus on errors only
  6. Time scope - Use from/to to search specific time periods

Performance

  • Search defaults to the message field for best performance
  • Adding more fields (especially data) increases query time
  • Use filters (level, source, etc.) to reduce the search space
  • For large result sets, use pagination with reasonable limits