CommunityProductivité et collaborationgithub.com

elastic/observability-edot-dotnet-migrate

Migrer une application .NET de l'agent APM .NET classique d'Elastic vers le SDK EDOT .NET. À utiliser lors du passage des packages Elastic.Apm.* vers Elastic.OpenTelemetry.

Qu'est-ce que observability-edot-dotnet-migrate ?

Cette compétence guide la migration d'une application .NET depuis l'agent APM .NET classique d'Elastic (basé sur les packages Elastic.Apm.*) vers le nouveau SDK EDOT .NET (Elastic OpenTelemetry .NET SDK). Elle est conçue pour les développeurs qui souhaitent moderniser leur instrumentation de télémétrie en adoptant l'approche standard OpenTelemetry tout en restant dans l'écosystème Elastic. La migration implique le remplacement des packages, la mise à jour du code de configuration de l'agent, et l'adaptation des appels API spécifiques à Elastic vers les API standard d'OpenTelemetry. La compétence prend en charge les applications .NET Core et .NET Framework, et fournit des instructions étape par étape pour un transfert en douceur, en préservant les fonctionnalités de surveillance des performances (APM) existantes. Elle est utile pour les équipes qui doivent évoluer vers un environnement plus interopérable et standardisé, sans perdre les avantages de l'observabilité Elastic.

Compatible avec~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 Productivité et collaboration skills: steipete/gemini, steipete/gh-issues, steipete/skill-creator · View all 6 →

Voir l'original→Voir toutes les compétences

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

Documentation

Que fait observability-edot-dotnet-migrate ?

Migrer une application .NET de l'agent APM .NET classique d'Elastic vers le SDK EDOT .NET. À utiliser lors du passage des packages Elastic.Apm.* vers Elastic.OpenTelemetry.

Aperçu

Cette compétence automatise la migration d'une application .NET existante utilisant l'agent APM .NET classique d'Elastic (paquets Elastic.Apm.*) vers le SDK EDOT .NET (paquet Elastic.OpenTelemetry). Elle garantit une transition en douceur avec un minimum d'interruptions.

Ce qu'elle fait

  • Identifie toutes les références aux paquets Elastic.Apm.* dans les fichiers projet
  • Remplace ces références par le paquet Elastic.OpenTelemetry
  • Met à jour le code de démarrage de l'agent (par exemple, Elastic.Apm.Agent.Start(...)) pour utiliser le nouveau SDK (par exemple, OpenTelemetry.Sdk.CreateTracerProviderBuilder(...))
  • Convertit les appels API spécifiques à Elastic en équivalents OpenTelemetry
  • Adapte les options de configuration et les paramètres de l'agent aux nouvelles APIs

Plateformes supportées

  • .NET Core 3.1 et versions ultérieures
  • .NET 5, 6, 7, 8, 9
  • .NET Framework 4.6.1 et versions ultérieures

Utilisation

  1. Assurez-vous que votre projet utilise actuellement Elastic.Apm.*.
  2. Exécutez cette compétence dans le répertoire racine de votre solution.
  3. Suivez les invites pour confirmer les modifications.
  4. Vérifiez la build et testez votre application.

Exemple

Avant (fichier projet .csproj) :

<PackageReference Include="Elastic.Apm" Version="1.24.0" />
<PackageReference Include="Elastic.Apm.AspNetCore" Version="1.24.0" />

Après :

<PackageReference Include="Elastic.OpenTelemetry" Version="1.0.0" />

Avant (code C#) :

using Elastic.Apm;

Agent.Start(new AgentComponents());

Après :

using OpenTelemetry;

using var tracerProvider = Sdk.CreateTracerProviderBuilder()
    .AddElasticOpenTelemetry()
    .AddAspNetCoreInstrumentation()
    .Build();

Avertissements

  • Sauvegardez votre code avant d'exécuter la migration.
  • Testez minutieusement après la migration, surtout si vous utilisez des fonctionnalités avancées comme les transactions personnalisées ou les spans.
  • Certaines options de configuration peuvent ne pas avoir d'équivalent direct dans OpenTelemetry.

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.

Skills associés

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 Productivité et collaboration skills