Registry / observability / spotlight-monitor

spotlight-monitor

library0.5.1pypypi✓ verified 80d ago

Spotlight Monitor is an AI-powered service monitoring SDK for Python. Version 0.5.1 supports Python >=3.9. It provides decorators and context managers to track service health, latency, and errors, integrating with OpenAI and Anthropic for intelligent alerting. Release cadence is irregular.

observability llm-agents

pip install spotlight-monitor

package ↗

INSTALL

IMPORT

SIG · SPOTLIGHT-MONITOR

spotlight-monitor

observabilitypythonv0.5.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Spotlight

✓ from spotlight_monitor import Spotlight

✗ from spotlight_monitor import monitor

Breadcrumb

✓ from spotlight_monitor import Breadcrumb

MetricsBatch

✓ from spotlight_monitor import MetricsBatch

Decorate any function to automatically monitor its execution. Set SPOTLIGHT_API_KEY environment variable.

import os from spotlight_monitor import monitor @monitor(service="my_service", api_key=os.environ.get('SPOTLIGHT_API_KEY', '')) def my_function(): return "Hello, world!" print(my_function())

Debug

Known issues

breakingVersion 0.5.0 changed the default export name from 'spotlight' to 'spotlight_monitor'. Imports using 'import spotlight' will break. Use 'import spotlight_monitor' or 'from spotlight_monitor import ...'.

fix

Change all imports to 'spotlight_monitor' instead of 'spotlight'.

affects: >=0.5.0

deprecatedThe keyword argument 'alert_provider' is deprecated as of 0.5.0. Use 'integrations' instead.

fix

Replace 'alert_provider="openai"' with 'integrations=["openai"]'.

affects: >=0.5.0

gotchaIf you omit the api_key parameter, the monitor will attempt to read SPOTLIGHT_API_KEY from environment variables. If not set, it will silently fall back to a local-only mode without AI features. This can be confusing when you expect AI alerts.

fix

Always set SPOTLIGHT_API_KEY or pass api_key explicitly to enable AI features.

affects: all

Upgrade

Version history

0.5.1latest on PyPI · released Jan 6, 2026

Audit

Dependencies

openaioptionalRequired for AI-powered alerting (e.g., OpenAI integration)

anthropicoptionalOptional for Anthropic integration

Agent activity

36 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/spotlight-monitor/ ↗