| name | geo-infer-ops |
| description | Operations, monitoring, and observability for geospatial infrastructure. Use when setting up monitoring dashboards, configuring alerts, tracking system health, or managing deployment of spatial services. |
| prerequisites | {"required":[],"recommended":["geo-infer-api","geo-infer-data"]} |
| difficulty | intermediate |
| estimated_time | 45min |
| examples_dir | ../GEO-INFER-EXAMPLES/examples/ |
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
