CommunityProdutividade e Colaboraçãogithub.com

elastic/observability-edot-dotnet-migrate

Migre uma aplicação .NET do agente clássico Elastic APM .NET para o SDK EDOT .NET. Use ao migrar de pacotes Elastic.Apm.* para Elastic.OpenTelemetry.

O que é observability-edot-dotnet-migrate?

Esta skill é projetada para auxiliar desenvolvedores .NET na migração de suas aplicações do agente clássico Elastic APM .NET para o SDK EDOT .NET baseado em OpenTelemetry. Ela automatiza a substituição de pacotes `Elastic.Apm.*` por `Elastic.OpenTelemetry`, ajusta a configuração de inicialização, e garante que a instrumentação automática e manual funcione corretamente com o novo pipeline OpenTelemetry. Útil para engenheiros que desejam modernizar sua observabilidade, a skill suporta plataformas como ASP.NET Core, .NET Framework e aplicações console. Ela opera modificando o arquivo de projeto (.csproj), substituindo chamadas de configuração do agente APM por inicialização do SDK EDOT, e atualizando referências a spans e transações para seguir o modelo OpenTelemetry.

Funciona com~Claude Code~Codex CLI~Cursor
Part ofAgent Workflows
npx skills add https://github.com/elastic/agent-skills/tree/main/skills/observability-edot-dotnet-migrate

Installed? Explore more Produtividade e Colaboração skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Ver original→Navegar por todas as habilidades

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentação

O que observability-edot-dotnet-migrate faz?

Migre uma aplicação .NET do agente clássico Elastic APM .NET para o SDK EDOT .NET. Use ao migrar de pacotes Elastic.Apm.* para Elastic.OpenTelemetry.

Visão Geral

Esta skill automatiza a migração de uma aplicação .NET do agente clássico Elastic APM .NET (pacotes Elastic.Apm.*) para o SDK EDOT .NET (Elastic.OpenTelemetry). Ela garante que a instrumentação automática, a captura de spans e transações, e a configuração sejam convertidas corretamente.

Plataformas Suportadas

  • ASP.NET Core
  • .NET Framework (com IIS)
  • Aplicações Console/Worker
  • Azure Functions (isolated process)

Pré-requisitos

  • Projeto .NET com agente clássico Elastic APM .NET instalado
  • SDK do .NET (dotnet CLI) disponível
  • Acesso ao feed NuGet oficial do Elastic (ou feed privado)

Processo de Migração

  1. Remover pacotes antigos: Desinstale Elastic.Apm.NetCoreAll, Elastic.Apm.AspNetCore, Elastic.Apm.EntityFrameworkCore, etc.
  2. Adicionar pacotes EDOT: Instale Elastic.OpenTelemetry e provedores OpenTelemetry adicionais necessários (ex.: OpenTelemetry.Instrumentation.AspNetCore).
  3. Atualizar configuração: Substitua Agent.Start(new AgentComponents()) por OpenTelemetrySdk.Create(builder => builder.UseElasticDefaultExporter()).
  4. Ajustar instrumentação manual: Troque IApmAgent e ITransaction por TracerProvider e Activity.
  5. Testar: Execute a aplicação e verifique se os traços aparecem no Kibana.

Exemplo de Código

Antes (Clássico APM):

using Elastic.Apm;

public void Configure(IApplicationBuilder app)
{
    app.UseElasticApm();
}

Depois (EDOT):

using OpenTelemetry;

public void Configure(IApplicationBuilder app)
{
    // Nenhuma chamada UseElasticApm necessária
}

Variáveis de Ambiente

  • ELASTIC_OTEL_*: Variáveis de configuração do EDOT (substituem ELASTIC_APM_*).
  • OTEL_EXPORTER_OTLP_ENDPOINT: Endpoint OTLP para exportação de dados.
  • OTEL_SERVICE_NAME: Nome do serviço (substitui ELASTIC_APM_SERVICE_NAME).

Notas Importantes

  • A migração é irreversível após a remoção dos pacotes antigos; faça backup do código.
  • Algumas funcionalidades do APM clássico podem não ter equivalentes diretos no OpenTelemetry (ex.: correlação de logs automática).
  • Consulte a documentação oficial do Elastic para detalhes finos.

Recursos

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

elastic/cloud-access-management

Manage Elastic Cloud organization access: invite users, assign roles to Serverless projects, and create or revoke Cloud API keys. Use when granting, modifying, or auditing user access.

elastic/cloud-create-project

Creates Elastic Cloud Serverless projects (Elasticsearch, Observability, or Security) via the REST API, saves credentials to file, and bootstraps a scoped Elasticsearch API key. Use when creating a new serverless project, provisioning a search or observability environment, or spinning up a new Elastic Cloud project.

elastic/cloud-manage-project

Manages existing Elastic Cloud Serverless projects: list, get, update, delete, reset credentials, resume, and load saved credentials. Connects to existing projects by resolving endpoints and acquiring scoped Elasticsearch API keys. Use when performing day-2 operations on serverless projects, connecting to an existing project, loading or resetting project credentials, or looking up project details.

elastic/cloud-network-security

Manage Serverless network security (traffic filters): create, update, and delete IP filters and AWS PrivateLink VPC filters. Use when restricting network access or configuring private connectivity.

elastic/cloud-setup

Configures Elastic Cloud authentication and environment defaults. Use when setting up EC_API_KEY, configuring Cloud API access, or when another cloud skill requires credentials.

elastic/elasticsearch-audit

Enable, configure, and query Elasticsearch security audit logs. Use when the task involves audit logging setup, event filtering, or investigating security incidents like failed logins.

elastic/elasticsearch-authn

Authenticate to Elasticsearch using native, file-based, LDAP/AD, SAML, OIDC, Kerberos, JWT, or certificate realms. Use when connecting with credentials, choosing a realm, or managing API keys. Assumes the target realms are already configured.

elastic/elasticsearch-authz

Manage Elasticsearch RBAC: native users, roles, role mappings, document- and field-level security. Use when creating users or roles, assigning privileges, or mapping external realms like LDAP/SAML.

elastic/elasticsearch-esql

Execute ES|QL (Elasticsearch Query Language) queries, use when the user wants to query Elasticsearch data, analyze logs, aggregate metrics, explore data, or create charts and dashboards from ES|QL results.

elastic/elasticsearch-file-ingest

Ingest and transform data files (CSV/JSON/Parquet/Arrow IPC) into Elasticsearch with stream processing and custom transforms. Use when loading files or batch importing data — not for reindexing, general ingest pipeline design, or bulk API patterns.

elastic/elasticsearch-onboarding

Help developers new to Elasticsearch get from zero to a working search experience. Guide them through understanding their intent, mapping their data, and building a search experience with best practices baked in. Use this when the user shows intent to build search-related functionality, asks about Elasticsearch-related concepts for their use case, or expresses the need for help getting started with Elasticsearch.

elastic/elasticsearch-security-troubleshooting

Diagnose and resolve Elasticsearch security errors: 401/403 failures, TLS problems, expired API keys, role mapping mismatches, and Kibana login issues. Use when the user reports a security error.

elastic/kibana-agent-builder

Create and manage Agent Builder agents and custom tools in Kibana. Use when asked to create, update, delete, test, or inspect agents or tools in Agent Builder.

elastic/kibana-alerting-rules

Create and manage Kibana alerting rules via REST API or Terraform. Use when creating, updating, or managing rule lifecycle (enable, disable, mute, snooze) or rules-as-code workflows.

elastic/kibana-audit

Enable and configure Kibana audit logging for saved object access, logins, and space operations. Use when setting up Kibana audit, filtering events, or correlating Kibana and ES audit logs.

elastic/kibana-connectors

Create and manage Kibana connectors for Slack, PagerDuty, Jira, webhooks, and more via REST API or Terraform. Use when configuring third-party integrations or managing connectors as code.

elastic/kibana-dashboards

Create and manage Kibana Dashboards and visualizations. Use when you need to define dashboards and visualizations declaratively, version control them, or automate their deployment.

elastic/kibana-streams

List, inspect, enable, disable, and resync Kibana Streams via the REST API. Use when the user needs stream details, ingest/query settings, queries, significant events, or attachments.

elastic/kibana-vega

Create Vega and Vega-Lite visualizations with ES|QL data sources in Kibana. Use when building custom charts, dashboards, or programmatic panel layouts beyond standard Lens charts.

elastic/observability-edot-dotnet-instrument

Instrument a .NET application with the Elastic Distribution of OpenTelemetry (EDOT) .NET SDK for automatic tracing, metrics, and logs. Use when adding observability to a .NET service that has no existing APM agent.

Habilidades Relacionadas

steipete/gemini

Gemini CLI one-shot prompts, summaries, generation, skills, hooks, MCP, or Gemma routing.

community

steipete/gh-issues

Fetch GitHub issues, select candidates, spawn background fix agents, open PRs, and optionally process PR review comments.

community

steipete/skill-creator

Create, edit, audit, tidy, validate, or restructure AgentSkills and SKILL.md files.

community

steipete/clawhub

Search, install, update, sync, or publish agent skills with the ClawHub CLI and registry.

community

steipete/coding-agent

Delegate coding work to Codex, Claude Code, or OpenCode as background workers; not simple edits or read-only code lookup.

community

steipete/mcporter

List, configure, authenticate, call, and inspect MCP servers/tools with mcporter over HTTP or stdio.

community
← More Produtividade e Colaboração skills