Logs Management
What is Logs Management?
Section titled “What is Logs Management?”Logs Management provides querying capabilities for accessing operational data from your Vidos services. Rather than simple log files, Vidos structures log data to enable efficient querying and analysis of service behavior, helping you troubleshoot issues and maintain audit records.
Vidos tracks two distinct types of logs, each serving different purposes in your infrastructure:
- Usage Logs: Detailed metrics about individual service instance operations
- Trail Logs: System-wide audit data across your entire infrastructure
How queries work
Section titled “How queries work”Logs Management uses an asynchronous query model to efficiently handle potentially large datasets:
sequenceDiagram
participant Client
participant API
Client->>API: Initiate Query
API-->>Client: queryExecutionId
Client->>API: Poll for Results
API-->>Client: Stream Results
This approach allows you to:
- Query large datasets without blocking
- Retrieve results at your own pace
- Use
nextTokenfor pagination through large result sets - Handle organization-wide queries efficiently
When initiating a query, you provide:
- Time range (
from,to): Required. Specifies the window of logs to search - HTTP method (optional): Filter by GET, POST, PUT, DELETE, or PATCH
- Pagination token (optional): Continue from a previous result set
The system returns a queryExecutionId immediately, then you poll to retrieve results as they become available.
Account isolation
Section titled “Account isolation”All logs respect your account boundaries:
- You can only query logs from your own account
- Each account’s logs are isolated from others
- Automatic capture happens transparently without manual intervention