Self-evolving Context Database for AI Agents. Unify Agent Memory, Knowledge RAG and Skills.
Python agent-contextagent-memoryagent-pluginsagentic-ragcontext-databasedsh-pluginknowledge-basememorymemory-managementself-evolvingvector-database
# Copyright (c) 2026 Beijing Volcano Engine Technology Co., Ltd.
# SPDX-License-Identifier: AGPL-3.0
"""
HTTP request lifecycle DataSource.
This DataSource emits two event types:
- http.request: for request count and duration metrics.
- http.inflight: for inflight request gauge.
The actual MetricRegistry writes are performed by HTTPCollector.
"""
from __future__ import annotations
from typing import Any
from .base import EventMetricDataSource
class HttpRequestLifecycleDataSource(EventMetricDataSource):
"""
Emit normalized HTTP lifecycle events for request counters, latency, and inflight gauges.
The datasource intentionally exposes a small, route-template-based payload shape so HTTP
collectors can remain agnostic of framework request objects.
"""
@staticmethod
def record_request(
*,
method: str,
route: str,
status: str,
duration_seconds: float,
account_id: str | None = None,
request_id: str | None = None,
user_id: str | None = None,
url_path: str | None = None,
result_count: int | None = None,
error_code: str | None = None,
error_message: str | None = None,
error_details: dict[str, Any] | None = None,
) -> None:
"""
Emit a completed-request event with normalized method, route, status, and duration data.
The payload is plain data so middleware can attach an explicit `account_id` when the
authenticated tenant is already known.
"""
payload = {
"method": str(method),
"route": str(route),
"status": str(status),
"duration_seconds": float(duration_seconds),
"account_id": None if account_id is None else str(account_id),
}
if request_id is not None:
payload["request_id"] = str(request_id)
if user_id is not None:
payload["user_id"] = str(user_id)
if url_path is not None:
payload["url_path"] = str(url_path)
if result_count is not None:
payload["result_count"] = max(int(result_count), 0)
if error_code is not None:
payload["error_code"] = str(error_code)
if error_message is not None:
payload["error_message"] = str(error_message)
if error_details is not None:
payload["error_details"] = dict(error_details)
EventMetricDataSource._emit("http.request", payload)
@staticmethod
def set_inflight(*, route: str, value: float, account_id: str | None = None) -> None:
"""
Emit the current inflight request gauge value for one normalized route template.
Callers are expected to supply the post-delta value so the datasource remains stateless.
"""
EventMetricDataSource._emit(
"http.inflight",
{
"route": str(route),
"value": float(value),
"account_id": None if account_id is None else str(account_id),
},
)