Migration Guides

This section provides guides for migrating to new features and patterns in kibana-py.

Available Guides

Space Support Migration

Learn how to migrate your code to use the new space support features, including space-scoped operations and the space_id parameter pattern.

Space Support Migration Guide
Log Forwarding Migration

Migrate from trace-only OpenTelemetry configuration to include log forwarding for complete observability.

Log Forwarding Migration Guide

When to Use Migration Guides

Migration guides help you:

  • Adopt new features while maintaining backward compatibility

  • Update existing code to use improved patterns

  • Understand breaking changes and how to address them

  • Optimize your implementation with best practices

Migration Support

If you encounter issues during migration:

  1. Check the Troubleshooting section

  2. Review the User Guide for detailed feature documentation

  3. Consult the API Reference for API details

  4. Open an issue on GitHub for additional help

Version Compatibility

Each migration guide specifies:

  • Minimum version required for new features

  • Deprecated features and their removal timeline

  • Backward compatibility guarantees

  • Testing recommendations to validate your migration