Logs (/v4/logs/...)

Source: src/Resource/V4/LogsResource.php

Real-time and historical application logs. The live streaming workflow has its own guide: Live log streaming. This page is the API reference.

Access

$client->logs

Methods

public function stream(string $applicationId, ?string $organisationId = null, array $filters = []): LogStream
public function query(string $applicationId, ?string $organisationId = null, array $filters = []): list<LogEntry>

Method	HTTP	Path	Returns
stream()	GET (SSE)	/v4/logs/.../applications/{appId}/logs	Iterable LogStream<LogEntry>
query()	GET	/v4/logs/.../applications/{appId}/logs	One-shot list<LogEntry>

stream() opens a Server-Sent Events connection via Symfony's EventSourceHttpClient. The returned LogStream implements IteratorAggregate<int, LogEntry> — foreach over it as logs arrive.

query() is a regular HTTP GET — same URL, different content negotiation; the server returns a JSON list instead of an event stream.

Filter shape

Both methods accept a $filters array:

public function stream(
    string $applicationId,
    ?string $organisationId = null,
    array $filters = [], // {since?, until?, filter?, deploymentId?}
): LogStream;

public function query(
    string $applicationId,
    ?string $organisationId = null,
    array $filters = [], // {since?, until?, filter?, deploymentId?, limit?}
): array;

Each key passes through to the API as a query parameter.

LogEntry DTO

See Live log streaming for the full field list. Key fields: message, severity, date, instanceId, zone, deploymentId.