Skip to content
azure-energy-data-services logo

azure-energy-data-services

Expert knowledge for Azure Energy Data Services development including troubleshooting, decision making, architecture & design patterns, security, configuration, integrations & coding patterns, and deployment. Use when configuring ADME partitions/zones, legal tags & ACLs, Petrel/seismic integratio...

MicrosoftDocs/Agent-Skills0installs770stars

SKILL.md

Full skill instructions

Azure Energy Data Services Skill

This skill provides expert guidance for Azure Energy Data Services. Covers troubleshooting, decision making, architecture & design patterns, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

  • Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
  • Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/​markdown. Returns Markdown.

Category Index

CategoryLinesDescription
TroubleshootingL35-L39Diagnosing and fixing manifest ingestion failures in Azure Data Manager for Energy using Airflow logs, including log analysis steps and common error patterns.
Decision MakingL40-L45Guidance on choosing ADME deployment tiers (Developer vs Standard) and checking which OSDU data/​compute services and capabilities are available in each tier.
Architecture & Design PatternsL46-L50Guidance on architecting resilient ADME deployments in Azure Energy Data Services, including zone redundancy, disaster recovery strategies, and high-availability design patterns.
SecurityL51-L65Securing ADME: auth tokens, ACLs, encryption, legal tags, user/​group entitlements, managed identities, private endpoints, API Management, and support access controls.
ConfigurationL66-L73Configuring Azure Energy Data Manager environments: partitions, analytics zones, CORS, audit logging, and milestone upgrade settings for governance and performance.
Integrations & Coding PatternsL74-L94Patterns and APIs for integrating Azure Energy Data Services with analytics platforms, external data sources, logs/​monitoring, and domain data stores (Petrel, seismic, wells, reservoirs).
DeploymentL95-L99Guides for deploying Azure Energy Data Services components, including Geospatial Consumption Zone on AKS and the OSDU Admin UI for Azure Data Manager for Energy administration

Troubleshooting

TopicURL
Troubleshoot manifest ingestion in Azure Data Manager for Energy using Airflow logshttps://learn.microsoft.com/en-us/azure/energy-data-services/troubleshoot-manifest-ingestion

Decision Making

Architecture & Design Patterns

Security

TopicURL
Use Customer Lockbox to control ADME support accesshttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-create-lockbox
Enable ACZ with managed identity and storage permissionshttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-enable-analytics-consumption-zone
Enable legal tags for restricted origin data in Azure Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-enable-legal-tags-restricted-country-of-origin
Generate auth and refresh tokens for Azure Data Manager for Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-generate-auth-token
Configure and update ACLs on ADME data recordshttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-manage-acls
Configure data security and encryption for Azure Data Manager for Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-manage-data-security-and-encryption
Create and manage legal tags for ADME datahttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-manage-legal-tags
Manage users and OSDU group entitlements in ADMEhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-manage-users
Secure Azure Data Manager for Energy APIs with API Managementhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-secure-apis
Create private endpoints for ADME with Azure Private Linkhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-set-up-private-links
Configure managed identities for Azure Data Manager for Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-use-managed-identity

Configuration

TopicURL
Add and manage data partitions in ADMEhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-add-more-data-partitions
Configure CORS policies for Azure Data Manager for Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-enable-cors
Configure and use audit logs in Azure Data Manager for Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-manage-audit-logs
Configure milestone upgrade settings for Azure Data Manager for Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-manage-upgrade-settings

Integrations & Coding Patterns

TopicURL
Integrate Azure Energy ACZ with Azure Databrickshttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-connect-analytics-consumption-zone-to-databricks
Connect Azure Energy ACZ data to Microsoft Fabrichttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-connect-analytics-consumption-zone-to-fabric
Enable External Data Services and Key Vault accesshttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-enable-external-data-services
Integrate Airflow task logs from ADME with Azure Monitorhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-integrate-airflow-logs-with-azure-monitor
Send ADME Elasticsearch logs to Azure Monitorhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-integrate-elastic-logs-with-azure-monitor
Export OSDU service logs from ADME to Azure Monitorhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-integrate-osdu-service-logs-with-azure-monitor
Register external data sources with ADME EDShttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-register-external-data-services
Upload large files via Azure Data Manager for Energy File service APIhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-upload-large-files-using-file-service
Manage Analytics Consumption Zones via ACZ REST APIshttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-analytics-consumption-zone-apis
Work with Petrel data via Petrel DDMS APIshttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-petrel-ddms
Read reservoir data using Reservoir DDMS REST APIshttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-reservoir-ddms-apis
Use Reservoir DDMS websocket endpoints for datahttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-reservoir-ddms-websocket
Call RAFS DDMS APIs for rock and fluid sampleshttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-rock-and-fluid-samples-ddms
Call Seismic DDMS APIs with cURLhttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-seismic-ddms
Use sdutil CLI to interact with Seismic Storehttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-seismic-ddms-sdutil
Manage well records with Well Delivery DDMS APIshttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-well-delivery-ddms
Use Wellbore DDMS APIs for well datahttps://learn.microsoft.com/en-us/azure/energy-data-services/tutorial-wellbore-ddms

Deployment

TopicURL
Deploy Geospatial Consumption Zone on AKS with Azure Data Manager for Energyhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-deploy-gcz
Deploy OSDU Admin UI for ADME administrationhttps://learn.microsoft.com/en-us/azure/energy-data-services/how-to-deploy-osdu-admin-ui