Server features (hasQueryTracesV2Support, supportQueryLogsByKeywords), cached.
One service by name: findService; null when unknown.
One native trace: queryTrace(traceId); null when unknown (OTLP trace ids are never native).
Raw GraphQL: returns {data, errors} (partial data possible). HTTP 400 (syntax/validation
errors) throws ValidationError.
Endpoints of a service: findEndpoint(keyword, serviceId, limit). keyword is a tokenised
match (downstream finds /native/downstream, down does not). No duration is sent (OAP
10.4 + BanyanDB returns nothing with one).
Optionalkeyword: stringInstances of a service active in range (default last hour): listInstances.
Optionalrange: TimeRangeLog tag keys seen in range (default last hour): queryLogTagAutocompleteKeys.
Optionalrange: TimeRangeServices: listServices(layer). layer null/omitted = all layers; an unknown layer → [].
OAP has no time filter for services, so range is accepted for API symmetry and ignored.
Services that only sent OTLP traces are not listed (use client.traces.listServices()).
Optional_range: TimeRangeLogs: queryLogs(condition). Either a window (default last hour) or traceId is sent;
see QueryLogsOptions.keywords for keyword handling on BanyanDB.
Native traces: queryTraces(condition) (whole traces). Durations in ms; tags must be
searchable keys. The legacy queryBasicTraces is not used (unsupported on BanyanDB).
OAP clock and timezone: getTimeInfo.
Service topology in range (default last hour): getGlobalTopology(duration, layer), or
getServiceTopology when opts.service is set. Native traffic only (OTLP spans create no
edges); includes the virtual User node.
Optionalrange: TimeRange
The SkyWalking GraphQL query API (
POST /graphqlon port 12800). Obtain it fromSkyWalkingClient.query. Services, instances and endpoints are named by their names; the SDK derives the ids (base64(name).1).