GEO-INFER-OPS

Instructions

Core Capabilities

• Monitoring: System health metrics, spatial operation performance
• Log aggregation: Structured log collection and querying
• Deployment: Configuration management for spatial services
• Observability: Distributed tracing for cross-module operations

Key Imports

from geo_infer_ops.core.monitoring import record_request, record_error, start_metrics_server
from geo_infer_ops.core.deployment import DeploymentManager
from geo_infer_ops.core.logging import setup_logging, get_logger

Examples

from geo_infer_ops.core.monitoring import record_request, start_metrics_server

with start_metrics_server(port=9090) as metrics_port:
    cells = backend.tessellate(region, resolution=7)
    record_request("space", "/h3/tessellate", 200, 0.12)
    print(f"Metrics listening on {metrics_port}")

from geo_infer_ops.core.deployment import DeploymentManager
from geo_infer_ops.core.logging import setup_logging, get_logger

setup_logging(log_level="INFO", json_format=True)
logger = get_logger(__name__)

deployer = DeploymentManager(namespace="geo-prod")
if deployer.build_docker_image(tag="geo-infer-api:local"):
    logger.info("docker_build_ready")

Guidelines

• Uses structured logging (JSON format)
• Prometheus-compatible metrics export
• start_metrics_server() yields the selected port and closes server/thread handles on exit
• Test: uv run python -m pytest GEO-INFER-OPS/tests/ -v

Integrations

• API → Endpoint monitoring and rate limiting
• AGENT → Agent telemetry collection and dashboards
• IOT → Sensor health monitoring and alerts
• LOG → Logistics operation monitoring
• SEC → Security event aggregation