v0.9.3

Released on February 12, 2026

Breaking Changes in 0.9.3

• DTAGENT_OWNER Role Introduction: Re-architected SnowAgent to introduce DTAGENT_OWNER role that owns all SnowAgent artifacts (database, schemas, tables, procedures, tasks). The DTAGENT_ADMIN role is now reserved exclusively for elevated administrative privileges, while DTAGENT_VIEWER handles regular telemetry-related operations.
• Deployment vs. Upgrade Permission Requirements: Deployment and upgrade now have separate permission requirements with the new owner-admin-viewer role separation model.
• Deployment Configuration: Configuration files are now in YAML format. Multi-configuration deployment is no longer supported. Each DSOA instance must be deployed separately with its own configuration. Use convert_config_to_yaml.sh script to convert existing JSON files.
• Configuration Structure: Reorganized Snowflake-related configuration into nested core.snowflake structure. The convert_config_to_yaml.sh script automatically migrates old paths to the new structure.

New in 0.9.3

• Admin Deployment Scope: New admin deployment scope for administrative operations, enabling granular control via --scope=admin option.
• Custom Snowflake Object Names: Added ability to customize names for all Snowflake objects (database, warehouse, resource monitor, roles). Set admin role or resource monitor to "-" to skip their creation entirely.
• Optional Object Deployment: When admin role or resource monitor is disabled via "-", related SQL code is automatically excluded from deployment scripts.

Fixed in 0.9.3

• Log Timestamp Handling: Fixed timestamps in logs being sent as nanoseconds instead of milliseconds.
• Event Log Resource Attributes: Fixed duplicated resource attribute fields in event log entries.
• Metric Dimension Array Formatting: Fixed issue where array-type dimensions (e.g., db.snowflake.dbs, db.snowflake.tables) were being sent to Dynatrace as Python list representations (e.g., ['DATABASE']) causing 400 Bad Request errors. Arrays are now properly converted to comma-separated strings (e.g., DATABASE or DB1,DB2,DB3).

Improved in 0.9.3

• Flexible Role Model: Implemented role hierarchy with ACCOUNTADMIN → DTAGENT_OWNER → DTAGENT_VIEWER as primary hierarchy and DTAGENT_OWNER → DTAGENT_ADMIN as optional admin branch.
• Security Model: Isolated administrative operations in dedicated admin scripts with automated tests to enforce separation.
• Selective Plugin Deployment: Enabled deployment with only selected plugins based on use case requirements.
• Custom Warehouse Support: Added ability to disable the built-in Resource Monitor or use a customer-provided warehouse.
• Data Retention Configuration: Added ability to configure data retention on DTAGENT_DB permanent tables (default: 1 day).
• Simplified Configuration Format: YAML format with lowercase keys to match Snowflake configuration table paths.
• Enhanced Deployment Script: Refactored deploy.sh with improved parameter handling using named parameters (--scope, --from-version, --output-file, --options).
• Structured Deployment Scopes: Introduced well-defined deployment scopes (init, admin, setup, plugins, config, agents, apikey, all, teardown, upgrade).
• Flexible Scope Combinations: The apikey deployment scope can now be combined with other scopes (e.g., setup,plugins,config,agents,apikey).
• Upgrade Process: Delivered upgrade process with --scope=upgrade --from-version=VERSION parameters, supporting custom queries for version migrations.
• Bill of Materials: BOM files are now included as part of the documentation with structured tables.
• Extended Code Quality: Extended code quality checks to include build/*.py files.

v0.9.2

Dynatrace Snowflake Observability Agent 0.9.2

Released on November 24, 2025

Breaking Changes in 0.9.2

• Self-monitoring Telemetry: All self-monitoring telemetry will now have dsoa.run.context set to self_monitoring (underscore) instead of self-monitoring (hyphen).

New in 0.9.2

• Example Dashboards: Added example dashboards to help users visualize and interpret telemetry data, including costs monitoring, self-monitoring, and Snowflake security dashboards with descriptions and screenshots.
• Configurable Query Analysis: Introduced options to configure minimum query runtime and the maximum number of top queries for deeper analysis, providing greater flexibility in performance monitoring.
• Telemetry Configuration: It is now possible to exclude certain telemetry types, e.g., events, spans, from being sent, either globally or on a per-plugin basis.
• Event Log Metrics: Extended support for RECORD_ATTRIBUTES in event log metrics for richer telemetry data.

Improved in 0.9.2

• Data Schema Plugin: Now reports on objects (tables, schemas, databases) modified by DDL queries as events.
• Query Robustness: Improved query robustness in the Resource Monitors and Users plugins by using explicit column selection to prevent errors from column order changes in SHOW WAREHOUSES and SNOWFLAKE.ACCOUNT_USAGE.USERS.
• Telemetry Sender: Enabled labeling and classification of telemetry calls for better differentiation and analysis of query data. Added SEND_TELEMETRY support for SHOW statements, enabling more flexible custom queries.
• Event Handling: Expanded event-handling capabilities, including support for sending multiple events in a single call and improved handling of Davis events.
• Metric Dimensions: Plugin and context names are now available as metric dimensions, improving traceability.
• Telemetry Query Performance: Improved performance of reading and processing telemetry data by using simpler queries. Added safety limits and ordering to event log queries to handle high-volume applications.
• Self-monitoring: Agent execution now returns detailed status information, including the number of telemetry objects sent by type, plugin, and run context. The deployment process also reports its start and finish as BizEvents, compatible with other telemetry.
• Configuration: API post timeout and retry delay are now configurable for metrics and events, providing better control over telemetry delivery.
• Code Quality & Testing: Streamlined internal plugin implementations and extended tests for all plugins. Added a suite of code quality checks to the automated build process.
• Documentation: Updated documentation to reflect new features, improved the structure for easier navigation as online GitHub pages, and added comprehensive troubleshooting guide for debugging data delivery issues.

v0.9.1

Dynatrace Snowflake Observability Agent 0.9.1

Released on September 18, 2025

Improved in 0.9.1

• Telemetry Sender: SEND_TELEMETRY procedure now supports SHOW statements, enabling more flexible and powerful custom queries
• Modular Documentation: The documentation has been restructured into multiple files (PLUGINS.md, SEMANTICS.md, APPENDIX.md) for improved readability and maintainability.

Fixed in 0.9.1

• Resource Monitors: Queries now use explicit column selection to prevent errors caused by changes in the column order of SHOW WAREHOUSES command results.
• Query History: Fixed upgrade for procedure P_REFRESH_RECENT_QUERIES to ensure it works correctly when upgrading from versions prior to 0.8.3.

CHANGELOG