google-cloud-profiler
Google Cloud Profiler Python Agent
Decision gist · record as of 2026-08-14
Yes, if you run Python applications on Google Cloud Platform and need production profiling. The active maintenance, permissive license, and zero known vulnerabilities support adoption. However, the high install friction (native compilation, Linux-only, Alpine special handling) and Python version ceiling (3.11 max) mean it's not suitable for all environments. Verify your deployment platform and Python version before committing.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Linux only (glibc or musl).
- Requires Python >= 3.7 and <= 3.11.
- Native compilation needed at install time; Alpine Linux requires build-base package.
License · maintenance · safety
Apache License, Version 2.0 (permissive) — Licensed under Apache License, Version 2.0 (permissive). You may use, modify, and distribute this package freely in commercial and private projects, provided you include a copy of the license and note any changes made.
last release 2023-08-16 (1094 days) · last repo commit 2026-04-08 · 32 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 419,232 downloads/mo, #6,801 on PyPI
Alternatives
Verify before relying
pip install google-cloud-profiler
import googlecloudprofiler
googlecloudprofiler.start(
service='my-service',
service_version='1.0.0',
verbose=2
)- Whether the package works on Python 3.12 or later despite classifier support ending at 3.11
- Current performance overhead of the daemon thread during continuous profiling
- Compatibility with non-GCP environments beyond the project_id workaround
What it is and what it does
Google Cloud Profiler Python Agent is a daemon-based profiler that continuously collects CPU, memory, and wall-time profiles from running Python applications and uploads them to Google Cloud Profiler for centralized analysis. It integrates directly into your application startup with a single initialization call and runs as a background thread, requiring minimal code changes.
The package is designed for production workloads on Google Cloud Platform but can work in other environments by specifying a project_id. It has a native compiled component, making installation platform-dependent: Linux systems with glibc or musl are supported, and Alpine Linux requires additional build tools. The profiler supports Python versions from 3.7 through 3.11 and is actively maintained by Google Cloud Platform.
Use it for
- Identify CPU hotspots and memory leaks in production Python services running on GCP without manual profiling.
- Continuously monitor application performance across multiple instances and correlate profiles with service versions.
- Debug performance regressions by comparing profiles across different service versions over time.
- Analyze resource consumption in containerized Python applications deployed on Google Cloud Run or GKE.
- Troubleshoot latency issues in long-running batch jobs or background workers on Compute Engine.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you run Python applications on Google Cloud Platform and need production profiling.
The active maintenance, permissive license, and zero known vulnerabilities support adoption. However, the high install friction (native compilation, Linux-only, Alpine special handling) and Python version ceiling (3.11 max) mean it's not suitable for all environments. Verify your deployment platform and Python version before committing.
Install
google-cloud-profiler on PyPI
Before you install
High install friction due to native compilation requirements. The package includes compiled components and requires build tools on Linux systems; Alpine Linux users must explicitly install build-base. Maintenance is active with recent commits, though the latest release was over a year ago.
Linux only (glibc or musl). Requires Python >= 3.7 and <= 3.11. Native compilation needed at install time; Alpine Linux requires build-base package. GCP credentials or project_id parameter required for operation.
License in practice
Licensed under Apache License, Version 2.0 (permissive). You may use, modify, and distribute this package freely in commercial and private projects, provided you include a copy of the license and note any changes made.
Quickstart
pip install google-cloud-profiler
import googlecloudprofiler
googlecloudprofiler.start(
service='my-service',
service_version='1.0.0',
verbose=2
)Verify before relying
- Whether the package works on Python 3.12 or later despite classifier support ending at 3.11
- Current performance overhead of the daemon thread during continuous profiling
- Compatibility with non-GCP environments beyond the project_id workaround
Package facts
| License | Apache License, Version 2.0 permissive |
| Python support | Not specified |
| Install friction | High. Source build required |
| Runtime dependencies | None |
| Maintenance | Actively maintained 1,094 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 419,232 / month, #6,801 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: google-cloud-profiler-4.1.0.tar.gz
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 › “python profiling agent gcp”
- google-cloud-profilerCollects and uploads CPU, memory, and wall-time profiles from Python…
- pyroscope-ioPyroscope-io is a continuous profiling agent that samples Python…
- codeguru-profiler-agentIntegrates Python applications with Amazon CodeGuru Profiler 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 codeguru-profiler-agent · google-python-cloud-debugger · cloud-tpu-diagnostics · pyroscope-io · scalene · google-cloud-mldiagnostics · py-spy · aws-cdk.aws-codeguruprofiler · ppk2-api · line-profiler