Error clusters
Reference for client.error_clusters in the Future AGI Python and TypeScript SDKs: error_clusters.get, error_clusters.list.
client.error_clusters on fi.Client (Python) and client.errorClusters on Client from @future-agi/sdk (TypeScript). The models these methods return are on Observability response models; how arguments, pagination, errors and strict mode work is in the overview.
Methods
| Method | Description |
|---|---|
error_clusters.get | Return an error issue and its grouped trace information. |
error_clusters.list | List grouped error issues detected in project traces. |
client.error_clusters
error_clusters.get
Return an error issue and its grouped trace information.
GET
/tracer/feed/issues/{cluster_id}/ MCP tool: get_error_cluster
result = client.error_clusters.get("your-cluster-id")const result = await client.errorClusters.get("your-cluster-id"); Signature
client.error_clusters.get(
cluster_id: str,
*,
project_id: str | None | NotGiven = NOT_GIVEN,
extra_query: dict[str, Any] | None = None,
options: RequestOptions | None = None,
) -> models.FeedDetailCoreclient.errorClusters.get(clusterId: string, params: ErrorClustersGetParams = {}, options?: RequestOptions): Promise<models.FeedDetailCore>
export interface ErrorClustersGetParams {
project_id?: string | null;
} Parameters
cluster_id
Positional argument cluster_id.
project_id
Returns
error_clusters.list
List grouped error issues detected in project traces.
GET
/tracer/feed/issues/ MCP tool: list_error_clusters
result = client.error_clusters.list()const result = await client.errorClusters.list(); Signature
client.error_clusters.list(
*,
project_id: str | None | NotGiven = NOT_GIVEN,
search: str | None | NotGiven = NOT_GIVEN,
status: Literal['escalating', 'for_review', 'acknowledged', 'resolved'] | None | NotGiven = NOT_GIVEN,
severity: Literal['critical', 'high', 'medium', 'low'] | None | NotGiven = NOT_GIVEN,
fix_layer: str | None | NotGiven = NOT_GIVEN,
source: Literal['scanner', 'eval'] | None | NotGiven = NOT_GIVEN,
issue_group: str | None | NotGiven = NOT_GIVEN,
time_range_days: int | None | NotGiven = NOT_GIVEN,
sort_by: Literal['last_seen', 'first_seen', 'error_count', 'unique_traces', 'severity'] | None | NotGiven = NOT_GIVEN,
sort_dir: Literal['asc', 'desc'] | None | NotGiven = NOT_GIVEN,
limit: int | None | NotGiven = NOT_GIVEN,
offset: int | None | NotGiven = NOT_GIVEN,
extra_query: dict[str, Any] | None = None,
options: RequestOptions | None = None,
) -> models.FeedListResponseclient.errorClusters.list(params: ErrorClustersListParams = {}, options?: RequestOptions): Promise<models.FeedListResponse>
export interface ErrorClustersListParams {
project_id?: string | null;
search?: string | null;
status?: "escalating" | "for_review" | "acknowledged" | "resolved" | null;
severity?: "critical" | "high" | "medium" | "low" | null;
fix_layer?: string | null;
source?: "scanner" | "eval" | null;
issue_group?: string | null;
time_range_days?: number | null;
sort_by?: "last_seen" | "first_seen" | "error_count" | "unique_traces" | "severity" | null;
sort_dir?: "asc" | "desc" | null;
limit?: number | null;
offset?: number | null;
} Parameters
project_id
search
status
Allowed values:
escalatingfor_reviewacknowledgedresolved severity
Allowed values:
criticalhighmediumlow fix_layer
source
Allowed values:
scannereval issue_group
time_range_days
sort_by
Allowed values:
last_seenfirst_seenerror_countunique_tracesseverity sort_dir
Allowed values:
ascdesc limit
offset
Returns
Was this page helpful?
Questions & Discussion