Guide de migration des couches .NET OpenTracing vers AWS Lambda

Ce guide décrit les principaux changements entre NewRelic.OpenTracing.AmazonLambda.Tracer et la couche Lambda de l'agent .NET. Il détaille également les différentes options disponibles lors de la mise à niveau et comment migrer avec succès vers l'utilisation de la couche Lambda de l'agent .NET.

Voici les principaux changements apportés à cette transition :

• Le package NewRelic.OpenTracing.AmazonLambda.Tracer est en conflit avec instrumentation d'agent et doit être supprimé.
• Toutes les modifications de code apportées à la fonction AWS Lambda pour OpenTracing doivent être annulées.
• L'agent .NET de New Relic sera utilisé pour instrumenter la fonction AWS Lambda.
• Les couches AWS Lambda sont disponibles lorsque vous regroupez l'agent .NET et l'extension New Relic Lambda requise.
• Dans la plupart des cas, l'instrumentation de la fonction AWS Lambda est automatique.
• L'agent .NET s'appuie sur l'extension New Relic Lambda pour l'envoi de données dans la fonction AWS Lambda.
• Les couches peuvent être configurées à l'aide de l'outil CLI New Relic Lambda , d'un plugin de framework Serverless ou manuellement.
• les noms et les timings métriques différeront car la façon dont la fonction est instrumentée a fondamentalement changé.
• Tout dashboard, alerte ou requête basé sur les anciennes métriques devra être mis à jour après la migration.

Suppression de NewRelic.OpenTracing.AmazonLambda.Tracer et OpenTracing

Le package NewRelic.OpenTracing.AmazonLambda.Tracer doit être supprimé avant d'utiliser l'agent .NET et toutes les modifications apportées à votre fonction AWS Lambda pour le prendre en charge doivent être annulées.

1. La configuration du package NewRelic.OpenTracing.AmazonLambda.Tracer nécessite la création d'un nouveau FunctionHandler qui appelle le FunctionHandler d'origine, en l'encapsulant pour permettre l'instrumentation. Avant de supprimer le NewRelic.OpenTracing.AmazonLambda.Tracer vous devrez annuler cet appel pour que le nettoyage se déroule plus facilement.
2. L'agent .NET ne prend pas en charge l'utilisation des API OpenTracing pour transmettre des données personnalisées. Toutes les modifications apportées à votre code qui s'appuient sur API OpenTracing, que ce soit directement ou via le package NewRelic.OpenTracing.AmazonLambda.Tracer, doivent être supprimées ou migrées pour utiliser l'API d'agent .NET.
3. Supprimez le package NewRelic.OpenTracing.AmazonLambda.Tracer de votre projet. Nettoyez tous les problèmes restants liés au retrait.

Sélection d'une méthode d'installation de couche

Après avoir supprimé le package NewRelic.OpenTracing.AmazonLambda.Tracer , l’étape suivante consiste à sélectionner la méthode que vous utiliserez pour installer et configurer la couche .NET AWS Lambda. Comme mentionné ci-dessus, il existe principalement trois options :

• Interface de ligne de commande Lambda de New Relic
• New Relic plugin de framework Serverless Relic
• Installation entièrement manuelle

Nous vous recommandons de choisir soit le plugin Lambda CLI, soit le plugin Serverless Framework, car ils automatisent la plupart de la configuration. Chacun a ses propres dépendances et exigences qui doivent être prises en considération, dont certaines seront décrites dans la section suivante. Si vous utilisez déjà l’une de ces approches, nous vous recommandons de simplifier les choses en utilisant la même approche pour toutes vos fonctions AWS Lambda.

Pour obtenir un ensemble complet d'instructions de démarrage détaillées pour le monitoring AWS Lambda, consultez notre guide d'activation.

Interface de ligne de commande Lambda de New Relic

Le Lambda CLI contient un exemple de commande permettant de mettre à jour quickstart votre AWS fonction Lambda pour utiliser la couche d'agent .NET. Cela détectera automatiquement le temps d'exécution de la fonction et sélectionnera la couche appropriée. Vous pouvez trouver des options de configuration supplémentaires dans le référentielLambda CLI (repository).

New Relic plugin de framework Serverless Relic

Le Serverless du plugin quickstart du framework contient les étapes requises pour installer le plugin et mettre à jour la du Serverless framework configuration. Vous pouvez trouver des options de configuration supplémentaires dans le référentiel (repository) du plugin frameworkServerless .

Installation entièrement manuelle

Bien que nous ne recommandions pas d'instrumenter manuellement votre fonction AWS Lambda, nous avons des informations sur les étapes nécessaires pour le faire ici.

• L'agent .NET instrumentera automatiquement votre fonction AWS Lambda, dans la plupart des cas lorsqu'il est installé manuellement
• L'extension New Relic Lambda est toujours requise pour l'envoi de données