netflix-spectator-py
Library for reporting metrics from Python applications to SpectatorD and the Netflix Atlas Timeseries Database.
Decision gist · record as of 2026-08-14
Yes, if you are running on Netflix infrastructure or have an Atlas/SpectatorD deployment. The library is lightweight, permissively licensed, and has no external dependencies. However, it is only useful if you have a compatible metrics backend; it is not a general-purpose metrics library for other backends (Prometheus, CloudWatch, etc.). Maintenance is aging but the repository remains active.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python 3.10 or later.
- Low install friction with no runtime dependencies.
- Maintenance status is aging—last release was 316 days ago—but the repository remains active and not archived, suggesting it is still in use despite infrequent updates.
License · maintenance · safety
Apache 2.0 (permissive) — Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions; suitable for both open-source and commercial projects.
last release 2025-10-02 (316 days) · last repo commit 2025-10-02 · 49 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 998,112 downloads/mo, #4,543 on PyPI
Alternatives
Verify before relying
pip install netflix-spectator-py
from spectator import Registry
registry = Registry()
counter = registry.counter('my.metric')
counter.increment()- Whether the package works with Python versions newer than 3.10 or only exactly 3.10+
- What specific metrics types and aggregations the library supports
- Whether SpectatorD and Atlas are freely available or Netflix-internal services
What it is and what it does
netflix-spectator-py is a lightweight Python client for reporting application metrics to Netflix's Atlas timeseries database and SpectatorD monitoring system. It provides a simple API for instrumenting Python applications with counters, gauges, timers, and other metric types, then pushing those metrics to a central monitoring backend for aggregation and analysis.
The library has no external runtime dependencies, making it lightweight to integrate into existing applications. It is maintained by Netflix and remains in active use, though releases are infrequent (last update 316 days ago). It requires Python 3.10 or later and is permissively licensed under Apache 2.0.
Use it for
- Instrument a Python web service to report request counts, latencies, and error rates to Atlas for dashboarding.
- Track application-level metrics (cache hits, database queries, job completions) in a centralized timeseries store.
- Monitor batch jobs or background workers by sending periodic metric snapshots to SpectatorD.
- Integrate metrics collection into a Netflix-managed infrastructure or on-premises Atlas deployment.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are running on Netflix infrastructure or have an Atlas/SpectatorD deployment.
The library is lightweight, permissively licensed, and has no external dependencies. However, it is only useful if you have a compatible metrics backend; it is not a general-purpose metrics library for other backends (Prometheus, CloudWatch, etc.). Maintenance is aging but the repository remains active.
Install
netflix-spectator-py on PyPI
Before you install
Low install friction with no runtime dependencies. Maintenance status is aging—last release was 316 days ago—but the repository remains active and not archived, suggesting it is still in use despite infrequent updates.
Requires Python 3.10 or later.
License in practice
Licensed under Apache 2.0 (permissive), allowing free use, modification, and distribution with minimal restrictions; suitable for both open-source and commercial projects.
Quickstart
pip install netflix-spectator-py
from spectator import Registry
registry = Registry()
counter = registry.counter('my.metric')
counter.increment()Verify before relying
- Whether the package works with Python versions newer than 3.10 or only exactly 3.10+
- What specific metrics types and aggregations the library supports
- Whether SpectatorD and Atlas are freely available or Netflix-internal services
Package facts
| License | Apache 2.0 permissive |
| Python support | Supports the current Python release >=3.10 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Aging 316 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 998,112 / month, #4,543 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: netflix_spectator_py-1.1.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “metrics reporting library”
- netflix-spectator-pyA thin-client metrics library that sends application metrics to…
- cloudml-hypertuneReports hyperparameter tuning metrics to Google CloudML Engine's…
- signalfxPython client library for sending metrics, events, and metadata to…
Give your agent the search over MCP, or paste the wish link into any chat.
More Monitoring packages
Wraps any iterable to display a real-time progress bar in the terminal or Jupyter notebook, showing iteration count, elapsed time, and estimated time remaining.
Provides generated Python code for OpenTelemetry semantic conventions, enabling standardized attribute naming and constant definitions for instrumentation and telemetry collection.
Install it if you are using OpenTelemetry and want to follow semantic conventions correctly.
Provides the reference implementation of the OpenTelemetry API for collecting and exporting traces, metrics, and logs from Python applications.
Provides the abstract API and interfaces for OpenTelemetry instrumentation in Python, defining how to emit traces, metrics, and logs without tying code to a specific SDK implementation.
Exports OpenTelemetry observability data to an OpenTelemetry Collector using Protobuf-encoded messages over HTTP.
Install it if you are using OpenTelemetry in Python and need to send data to a Collector over HTTP.
Provides automatic instrumentation commands and programmatic APIs to inject distributed tracing into Python applications without code changes, detecting and instrumenting packages used by your program.
Install it if you need distributed tracing without code changes and have compatible instrumented packages in your environment.
See also metaflow-netflixext · signalfx · atlasclient · azure-monitor-querymetrics · statsd · applicationinsights · jaeger-client · graphyte · newrelic-telemetry-sdk · couchbase