---
id: aliyun-log-python-sdk
version: "0.9.50"
license: unclear
license_treatment: permissive
maintenance: active
---

# aliyun-log-python-sdk — Aliyun log service Python client SDK

License: permissive · Maintenance: active · Downloads: 411.7K/mo

## What it is and what it does

This is the official Python SDK for Alibaba Cloud Log Service, a managed logging platform. It provides programmatic access to all Log Service REST APIs, including log ingestion, querying, project/logstore management, and consumer group operations. The SDK wraps low-level HTTP calls into higher-level Python classes and utilities, reducing boilerplate and handling common patterns like automatic pagination and retry logic.

The package includes specialized features for production use: a Python logging handler for direct integration with standard Python logging, high-level consumer group support for distributed log consumption, and ETL capabilities for cross-logstore data transformation and migration. It also supports Elasticsearch data migration. With 8 runtime dependencies (six, requests, python-dateutil, elasticsearch, jmespath, dateparser, protobuf, lz4), installation has moderate friction, but the SDK is actively maintained and supports Python versions from 2.7 through 3.12.

Use it for:

- Ingest application logs into Alibaba Cloud Log Service from Python applications for centralized log storage and analysis.
- Query and retrieve logs programmatically from Log Service for custom reporting, alerting, or post-processing workflows.
- Migrate log data from Elasticsearch or other sources into Alibaba Cloud Log Service using the SDK's migration utilities.
- Build ETL pipelines that transform and copy log data across multiple logstores within Log Service.
- Integrate Python's standard logging module with Alibaba Cloud Log Service via the provided logging handler.
- Manage Log Service projects and logstores (create, delete, update settings) from Python automation scripts.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for Alibaba Cloud Log Service that wraps the REST API to enable log ingestion, querying, management, and ETL operations on Alibaba's cloud logging platform.

Yes, if you are already using Alibaba Cloud Log Service and need a Python client. The SDK is actively maintained, permissively licensed, has no known vulnerabilities, and provides comprehensive API coverage. The high install friction (8 dependencies) and legacy Python 2.7 support are minor drawbacks; modern Python versions (3.7+) are well-supported. Not relevant if you are not using Alibaba's logging platform.

## Install

pip install aliyun-log-python-sdk
uv add aliyun-log-python-sdk
poetry add aliyun-log-python-sdk

## Installing aliyun-log-python-sdk

Before you install: High install friction due to 8 runtime dependencies including protobuf and lz4. Active maintenance with a recent release (1 day old) and steady repository activity, though the package targets both legacy Python 2.7 and modern versions.

License in practice: MIT license (permissive) means you can use, modify, and distribute this package freely in commercial and private projects with minimal restrictions.

Quickstart:

pip install aliyun-log-python-sdk

from aliyun.log import LogClient

client = LogClient('endpoint', 'access_id', 'access_key')
logs = client.get_logs('project', 'logstore', 'query')

Requires Alibaba Cloud credentials (endpoint, access ID, access key) and an active Alibaba Cloud Log Service account.

Verify before relying:

- Whether elasticsearch dependency is required for all use cases or only for migration features.
- Performance characteristics and throughput limits for high-volume log ingestion.
- Compatibility status with Python 2.7 given its EOL status and modern Python 3.12 support.

## Package facts

- License: not declared (permissive)
- Python support: unspecified
- Install friction: high
- Maintenance: active
- Downloads: 411.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

alibaba cloud log service sdk, aliyun log python client, cloud logging python sdk, log service rest api wrapper, alibaba cloud log ingestion, aliyun sls python, cloud log management sdk, alibaba-cloud, logging, etl

[View on SkillFed](https://skillfed.io/packages/aliyun-log-python-sdk) · [View on PyPI](https://pypi.org/project/aliyun-log-python-sdk/)