django-cfg 1.4.116__py3-none-any.whl → 1.5.8__py3-none-any.whl

django_cfg/apps/integrations/grpc/serializers/charts.py

@@ -0,0 +1,218 @@
+"""
+Pydantic serializers for gRPC charts and statistics data.
+
+These serializers define the structure for chart endpoints
+that provide time-series data for visualization.
+"""
+
+from typing import List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class TimeSeriesDataPoint(BaseModel):
+    """Single data point in time series."""
+
+    timestamp: str = Field(..., description="ISO timestamp")
+    value: float = Field(..., description="Value at this timestamp")
+    label: Optional[str] = Field(None, description="Optional label for this point")
+
+
+class ServerUptimeDataPoint(BaseModel):
+    """Server uptime data point."""
+
+    timestamp: str = Field(..., description="ISO timestamp")
+    server_count: int = Field(..., description="Number of running servers")
+    servers: List[str] = Field(
+        default_factory=list, description="List of server addresses"
+    )
+
+
+class RequestVolumeDataPoint(BaseModel):
+    """Request volume data point."""
+
+    timestamp: str = Field(..., description="ISO timestamp")
+    total_requests: int = Field(..., description="Total requests in period")
+    successful_requests: int = Field(..., description="Successful requests")
+    failed_requests: int = Field(..., description="Failed requests")
+    success_rate: float = Field(..., description="Success rate percentage")
+
+
+class ResponseTimeDataPoint(BaseModel):
+    """Response time statistics data point."""
+
+    timestamp: str = Field(..., description="ISO timestamp")
+    avg_duration_ms: float = Field(..., description="Average duration")
+    p50_duration_ms: float = Field(..., description="P50 percentile")
+    p95_duration_ms: float = Field(..., description="P95 percentile")
+    p99_duration_ms: float = Field(..., description="P99 percentile")
+    min_duration_ms: float = Field(..., description="Minimum duration")
+    max_duration_ms: float = Field(..., description="Maximum duration")
+
+
+class ServiceActivityDataPoint(BaseModel):
+    """Service activity data point."""
+
+    service_name: str = Field(..., description="Service name")
+    request_count: int = Field(..., description="Number of requests")
+    success_rate: float = Field(..., description="Success rate percentage")
+    avg_duration_ms: float = Field(..., description="Average duration")
+
+
+class ServerLifecycleEvent(BaseModel):
+    """Server lifecycle event."""
+
+    timestamp: str = Field(..., description="Event timestamp")
+    event_type: str = Field(
+        ..., description="Event type (started, stopped, error)"
+    )
+    server_address: str = Field(..., description="Server address")
+    server_pid: int = Field(..., description="Server process ID")
+    uptime_seconds: Optional[int] = Field(
+        None, description="Uptime at event time (for stop events)"
+    )
+    error_message: Optional[str] = Field(None, description="Error message if applicable")
+
+
+class TimeSeriesChartData(BaseModel):
+    """Generic time series chart data."""
+
+    title: str = Field(..., description="Chart title")
+    series_name: str = Field(..., description="Series name")
+    data_points: List[TimeSeriesDataPoint] = Field(
+        default_factory=list, description="Data points"
+    )
+    period_hours: int = Field(..., description="Period in hours")
+    granularity: str = Field(
+        ..., description="Data granularity (hour, day, week)"
+    )
+
+
+class ServerUptimeChartSerializer(BaseModel):
+    """Server uptime over time chart data."""
+
+    title: str = Field(default="Server Uptime", description="Chart title")
+    data_points: List[ServerUptimeDataPoint] = Field(
+        default_factory=list, description="Uptime data points"
+    )
+    period_hours: int = Field(..., description="Period in hours")
+    granularity: str = Field(..., description="Data granularity")
+    total_servers: int = Field(..., description="Total unique servers in period")
+    currently_running: int = Field(..., description="Currently running servers")
+
+
+class RequestVolumeChartSerializer(BaseModel):
+    """Request volume over time chart data."""
+
+    title: str = Field(default="Request Volume", description="Chart title")
+    data_points: List[RequestVolumeDataPoint] = Field(
+        default_factory=list, description="Volume data points"
+    )
+    period_hours: int = Field(..., description="Period in hours")
+    granularity: str = Field(..., description="Data granularity")
+    total_requests: int = Field(..., description="Total requests in period")
+    avg_success_rate: float = Field(..., description="Average success rate")
+
+
+class ResponseTimeChartSerializer(BaseModel):
+    """Response time over time chart data."""
+
+    title: str = Field(default="Response Time", description="Chart title")
+    data_points: List[ResponseTimeDataPoint] = Field(
+        default_factory=list, description="Response time data points"
+    )
+    period_hours: int = Field(..., description="Period in hours")
+    granularity: str = Field(..., description="Data granularity")
+    overall_avg_ms: float = Field(..., description="Overall average duration")
+    overall_p95_ms: float = Field(..., description="Overall P95 duration")
+
+
+class ServiceActivityChartSerializer(BaseModel):
+    """Service activity comparison chart data."""
+
+    title: str = Field(default="Service Activity", description="Chart title")
+    services: List[ServiceActivityDataPoint] = Field(
+        default_factory=list, description="Service activity data"
+    )
+    period_hours: int = Field(..., description="Period in hours")
+    total_services: int = Field(..., description="Total number of services")
+    most_active_service: Optional[str] = Field(
+        None, description="Most active service name"
+    )
+
+
+class ServerLifecycleChartSerializer(BaseModel):
+    """Server lifecycle events timeline."""
+
+    title: str = Field(default="Server Lifecycle", description="Chart title")
+    events: List[ServerLifecycleEvent] = Field(
+        default_factory=list, description="Lifecycle events"
+    )
+    period_hours: int = Field(..., description="Period in hours")
+    total_events: int = Field(..., description="Total number of events")
+    restart_count: int = Field(..., description="Number of server restarts")
+    error_count: int = Field(..., description="Number of error events")
+
+
+class ErrorDistributionDataPoint(BaseModel):
+    """Error distribution data point."""
+
+    error_code: str = Field(..., description="gRPC status code")
+    count: int = Field(..., description="Number of occurrences")
+    percentage: float = Field(..., description="Percentage of total errors")
+    service_name: Optional[str] = Field(None, description="Service name if filtered")
+
+
+class ErrorDistributionChartSerializer(BaseModel):
+    """Error distribution chart data."""
+
+    title: str = Field(default="Error Distribution", description="Chart title")
+    error_types: List[ErrorDistributionDataPoint] = Field(
+        default_factory=list, description="Error distribution data"
+    )
+    period_hours: int = Field(..., description="Period in hours")
+    total_errors: int = Field(..., description="Total number of errors")
+    most_common_error: Optional[str] = Field(
+        None, description="Most common error code"
+    )
+
+
+class DashboardChartsSerializer(BaseModel):
+    """Combined dashboard charts data."""
+
+    server_uptime: ServerUptimeChartSerializer = Field(
+        ..., description="Server uptime chart"
+    )
+    request_volume: RequestVolumeChartSerializer = Field(
+        ..., description="Request volume chart"
+    )
+    response_time: ResponseTimeChartSerializer = Field(
+        ..., description="Response time chart"
+    )
+    service_activity: ServiceActivityChartSerializer = Field(
+        ..., description="Service activity chart"
+    )
+    error_distribution: ErrorDistributionChartSerializer = Field(
+        ..., description="Error distribution chart"
+    )
+    period_hours: int = Field(..., description="Period in hours for all charts")
+    generated_at: str = Field(..., description="When data was generated")
+
+
+__all__ = [
+    "TimeSeriesDataPoint",
+    "ServerUptimeDataPoint",
+    "RequestVolumeDataPoint",
+    "ResponseTimeDataPoint",
+    "ServiceActivityDataPoint",
+    "ServerLifecycleEvent",
+    "TimeSeriesChartData",
+    "ServerUptimeChartSerializer",
+    "RequestVolumeChartSerializer",
+    "ResponseTimeChartSerializer",
+    "ServiceActivityChartSerializer",
+    "ServerLifecycleChartSerializer",
+    "ErrorDistributionDataPoint",
+    "ErrorDistributionChartSerializer",
+    "DashboardChartsSerializer",
+]

django_cfg/apps/integrations/grpc/serializers/config.py

@@ -0,0 +1,106 @@
+"""
+Pydantic serializers for gRPC configuration and server info.
+
+These serializers define the structure for configuration and server
+information endpoints.
+"""
+
+from typing import List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class GRPCServerConfigSerializer(BaseModel):
+    """gRPC server configuration details."""
+
+    host: str = Field(..., description="Server host address")
+    port: int = Field(..., description="Server port")
+    enabled: bool = Field(..., description="Whether gRPC server is enabled")
+    max_workers: int = Field(..., description="Maximum worker threads")
+    max_concurrent_rpcs: Optional[int] = Field(
+        None, description="Maximum concurrent RPCs"
+    )
+
+
+class GRPCFrameworkConfigSerializer(BaseModel):
+    """gRPC framework configuration details."""
+
+    enabled: bool = Field(..., description="Whether framework is enabled")
+    auto_discover: bool = Field(..., description="Auto-discover services")
+    services_path: str = Field(..., description="Services discovery path pattern")
+    interceptors: List[str] = Field(
+        default_factory=list, description="Registered interceptors"
+    )
+
+
+class GRPCFeaturesSerializer(BaseModel):
+    """gRPC features configuration."""
+
+    jwt_auth: bool = Field(..., description="JWT authentication enabled")
+    request_logging: bool = Field(..., description="Request logging enabled")
+    metrics: bool = Field(..., description="Metrics collection enabled")
+    reflection: bool = Field(..., description="gRPC reflection enabled")
+
+
+class GRPCConfigSerializer(BaseModel):
+    """Complete gRPC configuration response."""
+
+    server: GRPCServerConfigSerializer = Field(..., description="Server configuration")
+    framework: GRPCFrameworkConfigSerializer = Field(
+        ..., description="Framework configuration"
+    )
+    features: GRPCFeaturesSerializer = Field(..., description="Feature flags")
+    registered_services: int = Field(..., description="Number of registered services")
+    total_methods: int = Field(..., description="Total number of methods")
+
+
+class GRPCServiceInfoSerializer(BaseModel):
+    """Information about a single gRPC service."""
+
+    name: str = Field(..., description="Service name")
+    methods: List[str] = Field(default_factory=list, description="Service methods")
+    full_name: str = Field(..., description="Full service name with package")
+    description: str = Field("", description="Service description")
+
+
+class GRPCInterceptorInfoSerializer(BaseModel):
+    """Information about an interceptor."""
+
+    name: str = Field(..., description="Interceptor name")
+    enabled: bool = Field(..., description="Whether interceptor is enabled")
+
+
+class GRPCStatsSerializer(BaseModel):
+    """Runtime statistics summary."""
+
+    total_requests: int = Field(..., description="Total number of requests")
+    success_rate: float = Field(..., description="Success rate percentage")
+    avg_duration_ms: float = Field(..., description="Average duration in milliseconds")
+
+
+class GRPCServerInfoSerializer(BaseModel):
+    """Complete gRPC server information response."""
+
+    server_status: str = Field(..., description="Server status (running, stopped)")
+    address: str = Field(..., description="Server address (host:port)")
+    started_at: Optional[str] = Field(None, description="Server start timestamp")
+    uptime_seconds: Optional[int] = Field(None, description="Server uptime in seconds")
+    services: List[GRPCServiceInfoSerializer] = Field(
+        default_factory=list, description="Registered services"
+    )
+    interceptors: List[GRPCInterceptorInfoSerializer] = Field(
+        default_factory=list, description="Active interceptors"
+    )
+    stats: GRPCStatsSerializer = Field(..., description="Runtime statistics")
+
+
+__all__ = [
+    "GRPCConfigSerializer",
+    "GRPCServerInfoSerializer",
+    "GRPCServerConfigSerializer",
+    "GRPCFrameworkConfigSerializer",
+    "GRPCFeaturesSerializer",
+    "GRPCServiceInfoSerializer",
+    "GRPCInterceptorInfoSerializer",
+    "GRPCStatsSerializer",
+]

django_cfg/apps/integrations/grpc/serializers/health.py

@@ -0,0 +1,18 @@
+"""
+Health check serializer for gRPC monitoring API.
+"""
+
+from pydantic import BaseModel, Field
+
+
+class GRPCHealthCheckSerializer(BaseModel):
+    """gRPC health check response."""
+
+    status: str = Field(description="Health status: healthy or unhealthy")
+    server_host: str = Field(description="Configured gRPC server host")
+    server_port: int = Field(description="Configured gRPC server port")
+    enabled: bool = Field(description="Whether gRPC is enabled")
+    timestamp: str = Field(description="Current timestamp")
+
+
+__all__ = ["GRPCHealthCheckSerializer"]

django_cfg/apps/integrations/grpc/serializers/requests.py

@@ -0,0 +1,18 @@
+"""
+Requests serializers for gRPC monitoring API.
+"""
+
+from pydantic import BaseModel, Field
+
+
+class RecentRequestsSerializer(BaseModel):
+    """Recent gRPC requests list."""
+
+    requests: list[dict] = Field(description="List of recent requests")
+    count: int = Field(description="Number of requests returned")
+    total_available: int = Field(description="Total requests available")
+    offset: int = Field(default=0, description="Current offset for pagination")
+    has_more: bool = Field(default=False, description="Whether more results are available")
+
+
+__all__ = ["RecentRequestsSerializer"]

django_cfg/apps/integrations/grpc/serializers/service_registry.py

@@ -0,0 +1,191 @@
+"""
+Pydantic serializers for gRPC Service Registry API.
+
+These serializers define the structure for service registry endpoints
+that provide detailed information about registered gRPC services and their methods.
+"""
+
+from typing import Dict, List, Optional
+
+from pydantic import BaseModel, Field
+
+
+class ServiceSummarySerializer(BaseModel):
+    """Summary information for a single service."""
+
+    name: str = Field(..., description="Service name (e.g., myapp.UserService)")
+    full_name: str = Field(..., description="Full service name with package")
+    package: str = Field(..., description="Package name")
+    methods_count: int = Field(..., description="Number of methods in service")
+    total_requests: int = Field(0, description="Total requests to this service")
+    success_rate: float = Field(0.0, description="Success rate percentage")
+    avg_duration_ms: float = Field(0.0, description="Average duration in milliseconds")
+    last_activity_at: Optional[str] = Field(None, description="Last activity timestamp")
+
+
+class ServiceListSerializer(BaseModel):
+    """List of services response."""
+
+    services: List[ServiceSummarySerializer] = Field(
+        default_factory=list, description="List of services"
+    )
+    total_services: int = Field(..., description="Total number of services")
+
+
+class MethodInfoSerializer(BaseModel):
+    """Information about a service method."""
+
+    name: str = Field(..., description="Method name")
+    full_name: str = Field(..., description="Full method name (/service/method)")
+    request_type: str = Field("", description="Request message type")
+    response_type: str = Field("", description="Response message type")
+    streaming: bool = Field(False, description="Whether method uses streaming")
+    auth_required: bool = Field(False, description="Whether authentication is required")
+
+
+class ServiceStatsSerializer(BaseModel):
+    """Service statistics."""
+
+    total_requests: int = Field(0, description="Total requests")
+    successful: int = Field(0, description="Successful requests")
+    errors: int = Field(0, description="Failed requests")
+    success_rate: float = Field(0.0, description="Success rate percentage")
+    avg_duration_ms: float = Field(0.0, description="Average duration in milliseconds")
+    last_24h_requests: int = Field(0, description="Requests in last 24 hours")
+
+
+class RecentErrorSerializer(BaseModel):
+    """Recent error information."""
+
+    method: str = Field(..., description="Method name where error occurred")
+    error_message: str = Field(..., description="Error message")
+    grpc_status_code: str = Field(..., description="gRPC status code")
+    occurred_at: str = Field(..., description="When error occurred (ISO timestamp)")
+
+
+class ServiceDetailSerializer(BaseModel):
+    """Detailed information about a service."""
+
+    name: str = Field(..., description="Service name")
+    full_name: str = Field(..., description="Full service name with package")
+    package: str = Field(..., description="Package name")
+    description: str = Field("", description="Service description from docstring")
+    file_path: str = Field("", description="Path to service file")
+    class_name: str = Field(..., description="Service class name")
+    base_class: str = Field("", description="Base class name")
+    methods: List[MethodInfoSerializer] = Field(
+        default_factory=list, description="Service methods"
+    )
+    stats: ServiceStatsSerializer = Field(..., description="Service statistics")
+    recent_errors: List[RecentErrorSerializer] = Field(
+        default_factory=list, description="Recent errors"
+    )
+
+
+class MethodStatsSerializer(BaseModel):
+    """Statistics for a single method."""
+
+    total_requests: int = Field(0, description="Total requests")
+    successful: int = Field(0, description="Successful requests")
+    errors: int = Field(0, description="Failed requests")
+    success_rate: float = Field(0.0, description="Success rate percentage")
+    avg_duration_ms: float = Field(0.0, description="Average duration in milliseconds")
+    p50_duration_ms: float = Field(0.0, description="P50 duration in milliseconds")
+    p95_duration_ms: float = Field(0.0, description="P95 duration in milliseconds")
+    p99_duration_ms: float = Field(0.0, description="P99 duration in milliseconds")
+
+
+class MethodSummarySerializer(BaseModel):
+    """Summary information for a method."""
+
+    name: str = Field(..., description="Method name")
+    full_name: str = Field(..., description="Full method path")
+    service_name: str = Field(..., description="Service name")
+    request_type: str = Field("", description="Request message type")
+    response_type: str = Field("", description="Response message type")
+    stats: MethodStatsSerializer = Field(..., description="Method statistics")
+
+
+class ServiceMethodsSerializer(BaseModel):
+    """List of methods for a service."""
+
+    service_name: str = Field(..., description="Service name")
+    methods: List[MethodSummarySerializer] = Field(
+        default_factory=list, description="List of methods"
+    )
+    total_methods: int = Field(..., description="Total number of methods")
+
+
+class RequestSchemaField(BaseModel):
+    """Schema field information."""
+
+    name: str = Field(..., description="Field name")
+    type: str = Field(..., description="Field type")
+    required: bool = Field(False, description="Whether field is required")
+    description: str = Field("", description="Field description")
+
+
+class RequestSchemaSerializer(BaseModel):
+    """Request message schema."""
+
+    fields: List[RequestSchemaField] = Field(
+        default_factory=list, description="Schema fields"
+    )
+
+
+class RecentRequestSerializer(BaseModel):
+    """Recent request information."""
+
+    id: int = Field(..., description="Database ID")
+    request_id: str = Field(..., description="Request ID")
+    service_name: str = Field(..., description="Service name")
+    method_name: str = Field(..., description="Method name")
+    status: str = Field(..., description="Request status")
+    duration_ms: int = Field(0, description="Duration in milliseconds")
+    grpc_status_code: str = Field("", description="gRPC status code")
+    error_message: str = Field("", description="Error message if failed")
+    created_at: str = Field(..., description="Request timestamp")
+    client_ip: str = Field("", description="Client IP address")
+
+
+class MethodDetailSerializer(BaseModel):
+    """Detailed information about a method."""
+
+    name: str = Field(..., description="Method name")
+    full_name: str = Field(..., description="Full method path")
+    service_name: str = Field(..., description="Service name")
+    request_type: str = Field("", description="Request message type")
+    response_type: str = Field("", description="Response message type")
+    streaming: bool = Field(False, description="Whether method uses streaming")
+    auth_required: bool = Field(False, description="Whether authentication is required")
+    description: str = Field("", description="Method description")
+    request_schema: RequestSchemaSerializer = Field(
+        ..., description="Request message schema"
+    )
+    response_schema: RequestSchemaSerializer = Field(
+        ..., description="Response message schema"
+    )
+    stats: MethodStatsSerializer = Field(..., description="Method statistics")
+    recent_requests: List[RecentRequestSerializer] = Field(
+        default_factory=list, description="Recent requests"
+    )
+    error_distribution: Dict[str, int] = Field(
+        default_factory=dict, description="Error distribution by status code"
+    )
+
+
+__all__ = [
+    "ServiceSummarySerializer",
+    "ServiceListSerializer",
+    "ServiceDetailSerializer",
+    "ServiceStatsSerializer",
+    "MethodInfoSerializer",
+    "MethodSummarySerializer",
+    "ServiceMethodsSerializer",
+    "MethodStatsSerializer",
+    "MethodDetailSerializer",
+    "RecentErrorSerializer",
+    "RecentRequestSerializer",
+    "RequestSchemaSerializer",
+    "RequestSchemaField",
+]

django_cfg/apps/integrations/grpc/serializers/services.py

@@ -0,0 +1,50 @@
+"""
+Services serializers for gRPC monitoring API.
+"""
+
+from pydantic import BaseModel, Field
+
+
+class MonitoringServiceStatsSerializer(BaseModel):
+    """Statistics for a single gRPC service (monitoring endpoint)."""
+
+    service_name: str = Field(description="Service name")
+    total: int = Field(description="Total requests")
+    successful: int = Field(description="Successful requests")
+    errors: int = Field(description="Error requests")
+    avg_duration_ms: float = Field(description="Average duration")
+    last_activity_at: str | None = Field(description="Last activity timestamp")
+
+
+class ServiceListSerializer(BaseModel):
+    """List of gRPC services with statistics."""
+
+    services: list[MonitoringServiceStatsSerializer] = Field(description="Service statistics")
+    total_services: int = Field(description="Total number of services")
+
+
+class MethodStatsSerializer(BaseModel):
+    """Statistics for a single gRPC method."""
+
+    method_name: str = Field(description="Method name")
+    service_name: str = Field(description="Service name")
+    total: int = Field(description="Total requests")
+    successful: int = Field(description="Successful requests")
+    errors: int = Field(description="Error requests")
+    avg_duration_ms: float = Field(description="Average duration")
+    last_activity_at: str | None = Field(description="Last activity timestamp")
+
+
+class MethodListSerializer(BaseModel):
+    """List of gRPC methods with statistics."""
+
+    methods: list[MethodStatsSerializer] = Field(description="Method statistics")
+    total_methods: int = Field(description="Total number of methods")
+
+
+__all__ = [
+    "MonitoringServiceStatsSerializer",
+    "ServiceListSerializer",
+    "MethodStatsSerializer",
+    "MethodListSerializer",
+]

django_cfg/apps/integrations/grpc/serializers/stats.py

@@ -0,0 +1,22 @@
+"""
+Statistics serializers for gRPC monitoring API.
+"""
+
+from pydantic import BaseModel, Field
+
+
+class GRPCOverviewStatsSerializer(BaseModel):
+    """Overview statistics for gRPC requests."""
+
+    total: int = Field(description="Total requests in period")
+    successful: int = Field(description="Successful requests")
+    errors: int = Field(description="Error requests")
+    cancelled: int = Field(description="Cancelled requests")
+    timeout: int = Field(description="Timeout requests")
+    success_rate: float = Field(description="Success rate percentage")
+    avg_duration_ms: float = Field(description="Average duration in milliseconds")
+    p95_duration_ms: float = Field(description="95th percentile duration in milliseconds")
+    period_hours: int = Field(description="Statistics period in hours")
+
+
+__all__ = ["GRPCOverviewStatsSerializer"]