Skip to main content

​
LogTracesClient

adaline.logs.traces searches traces with typed column filters — status, time window, name, attributes — and retroactively patches a trace’s status, tags, or attributes after it has already been flushed. Every method is async.

​
Access

from adaline.main import Adaline

adaline = Adaline()
traces = adaline.logs.traces  # LogTracesClient
The class is also exported directly: 
from adaline.clients import LogTracesClient
Types from adaline_api: 
from adaline_api.models.search_log_traces_request import SearchLogTracesRequest
from adaline_api.models.search_traces_response import SearchTracesResponse
from adaline_api.models.update_log_trace_request import UpdateLogTraceRequest
Paginated trace search with typed filter objects. 
async def search(*, query: SearchLogTracesRequest) -> SearchTracesResponse

​
Parameters

NameTypeRequiredDescription
querySearchLogTracesRequestYesProject, filters, sort, pagination. See Export Logs for filter grammar.

​
Returns

SearchTracesResponse with { data: list[TraceRow]; pagination: Pagination }.

​
Example

from adaline_api.models.search_log_traces_request import SearchLogTracesRequest
import time

response = await adaline.logs.traces.search(
    query=SearchLogTracesRequest(
        project_id="project_abc123",
        filters=[
            {"type": "status", "column": "status", "operator": "equals", "value": "failure"},
            {"type": "startedAt", "column": "startedAt", "operator": "gte", "value": int((time.time() - 3600) * 1000)},
        ],
        sort="startedAt:desc",
        limit=100,
    )
)

for trace in response.data:
    print(trace.id, trace.name, trace.status)

​
update()

Retroactively patch a trace’s status/endedAt and create or delete tags and attributes. Locate the trace by trace_id or reference_id (at least one required). 
async def update(*, trace: UpdateLogTraceRequest) -> Any

​
Example

from adaline_api.models.update_log_trace_request import UpdateLogTraceRequest

await adaline.logs.traces.update(
    trace=UpdateLogTraceRequest(
        reference_id="user-session-123",
        status="success",
        attributes={"resolved": "by-support"},
    )
)

​
See Also