Vous pouvez mettre à niveau vos fonctions Lambda existantes vers la nouvelle expérience de monitoring unifiée avec un minimum d'effort. Cette transition vous permet de monitorer vos fonctions Lambda avec les capacités d'observabilité améliorées de New Relic. Vous pouvez instrumenter toutes vos fonctions Lambda existantes en masse, ou vous pouvez choisir de les mettre à niveau une par une. Le processus de mise à niveau est non intrusif et ne nécessite aucune modification de code de vos fonctions existantes.
Cette mise à niveau s’applique aux fonctions Lambda instrumentées avec des couches Lambda New Relic ou des couches OpenTelemetry (ADOT). Les deux types de couches offrent la même expérience d’interface utilisateur APM.
Conseil
Utilisateurs de Lambda Managed Instance (LMI): aucune étape de mise à niveau n’est requise. Les fonctions LMI sont automatiquement détectées et configurées pour s’exécuter en mode APM, même sans définir NEW_RELIC_APM_LAMBDA_MODE = true. Notez que le mode Serverless n’est pas pris en charge pour LMI ; seul le mode APM est disponible. Consultez Instrumentation par couches pour obtenir des détails sur la configuration de LMI.
Prérequis
- Vos fonctions Lambda sont déjà instrumentées dans New Relic.
- Vos fonctions Lambda s'exécutent sur l'un des runtimes
python,nodejs,ruby,goou.NET. Pour afficher la liste des versions prises en charge de ces runtimes, reportez-vous à la documentation sur la compatibilité et les exigences.
Méthodes d'instrumentation
Vous pouvez mettre à niveau vos fonctions Lambda existantes en utilisant l'une des méthodes suivantes :
Conseil
New Relic recommande d'intégrer votre compte AWS à New Relic en utilisant l' intégration AWS pour découvrir et monitorer automatiquement votre fonction Lambda. Cela vous permet d'exploiter pleinement la puissance de New Relic APM pour votre serveur de fonctions.
Mettre à jour via l’UI de New Relic
Vous pouvez mettre à niveau vos fonctions Lambda existantes à l'aide de l'interface utilisateur de New Relic.
Pour mettre à niveau vos fonctions Lambda existantes à partir de la plateforme New Relic, procédez comme suit :
- Allez à one.newrelic.com > All capabilities > Serverless Functions > sélectionnez votre entité de fonction Lambda.
- Sur la page Summary, cliquez sur Instrument for APM.
- Sur la page Fonction Lambda pour APM, fournissez la clé API, puis cliquez sur Continue.
- Par défaut, l’entité Lambda actuelle est sélectionnée pour la mise à niveau. Vous pouvez également sélectionner d’autres fonctions Lambda à mettre à niveau. Cliquez sur Generate New Relic CLI command.
- Copiez la commande et exécutez-la dans votre terminal ou dans votre terminal AWS. La commande installera la couche Lambda New Relic sur les fonctions sélectionnées.
- Cliquez sur Continue pour tester l'installation. Le test vérifiera si la couche Lambda New Relic est correctement installée et si la fonction envoie des données à New Relic.
- Si le test réussit, vous verrez un message de réussite. Pour afficher votre fonction Lambda dans l’interface New Relic APM, cliquez sur See your data in APM.
Mettre à jour à l'aide des CLI
Mettre à jour les alertes et les dashboards Lambda existants
Après avoir mis à niveau vos fonctions Lambda existantes vers APM + Serverless Convergence, il est essentiel de mettre à jour les requêtes NRQL dans vos conditions d'alerte et vos widgets de dashboard. Cette nouvelle mise à niveau modifie les chemins de métriques pour vos données Lambda. La modification de vos requêtes est nécessaire pour garantir que vos alertes et vos dashboards utilisent ces nouveaux chemins et continuent de fournir un monitoring et des notifications précises. Ceci est requis pour toutes les fonctions Lambda existantes que vous avez migrées vers APM + Serverless Convergence.
Pour les alertes, examinez vos conditions d'alerte Lambda existantes. Mettez à jour toutes les requêtes NRQL qui utilisent des métriques provenant de couches avec les nouvelles métriques. Pour plus d'informations sur la mise à jour de vos conditions d'alerte, reportez-vous à la section Mettre à jour une alerte.
Pour les dashboards, examinez vos widgets de dashboard Lambda existants. Mettez à jour toutes les requêtes NRQL qui utilisent des métriques provenant de couches avec les nouvelles métriques. Pour plus d'informations sur la mise à jour de vos widgets de dashboard, reportez-vous à la section gérer le dashboard.
Rechercher et utiliser des données
Une fois votre fonction AWS Lambda instrumentée, vous pouvez trouver et utiliser les données dans l’interface New Relic APM. Les fonctions Lambda instrumentées via OpenTelemetry (couche ADOT) affichent désormais la même expérience de l’UI APM que les fonctions instrumentées avec les agents New Relic APM, y compris une page Summary cohérente et des métriques normalisées au format apm.*.
Pour afficher votre fonction Lambda dans l'interface New Relic APM :
- Allez à one.newrelic.com > APM & Services.
- Définissez les critères de recherche comme
isLambdaFunction = true. - Dans la liste affichée, sélectionnez votre fonction Lambda pour afficher les données.
Important
L'interface utilisateur APM de New Relic n'affiche pas les données historiques des fonctions Lambda qui ont été instrumentées avant la mise à niveau APM + Serverless Convergence. Pour afficher les données historiques, cliquez sur see serverless functions dans la page APM Summary.
Résumé
La page Summary offre un aperçu rapide des données de performances les plus importantes pour votre fonction Lambda, notamment le temps de réponse, le débit, et le taux d’erreur. Cette page est disponible pour les fonctions Lambda instrumentées par APM et instrumentées par OpenTelemetry (ADOT).
métriques CloudWatch
L’onglet CloudWatch metrics affiche les données de performances Lambda provenant d’AWS CloudWatch via la couche de synthèse de métriques de New Relic. Les graphiques incluent :
- Nombre d’invocations
- Durée
- Limitations
- Nombre d'erreurs
Cet onglet est disponible pour les fonctions Lambda instrumentées par APM et instrumentées par OpenTelemetry (ADOT).
Métriques Lambda
L’onglet Lambda metrics affiche les données de performances provenant directement de la couche Lambda New Relic. Il est organisé en deux sections :
- Coûts: graphiques des invocations et de l'utilisation de la mémoire.
- Performance: démarrages à froid, délais d'attente, âge de l'itérateur, et exécutions simultanées.
callout.note
Pour les fonctions Lambda s’exécutant en mode Lambda Managed Instance (LMI), le graphique Billed duration n’est pas affiché dans la section Coûts. La facturation LMI est basée sur le coût EC2, les frais de gestion, et l’utilisation du vCPU, et non sur la durée d’exécution Lambda.
Transactions
L’onglet Transactions répertorie les transactions Lambda avec des données de performance telles que la durée et le débit. La colonne AWS Request ID identifie chaque exécution Lambda par son identifiant de requête AWS unique, ce qui vous permet d’explorer la trace de transaction APM d’une invocation spécifique pour obtenir des informations détaillées sur cette exécution Lambda particulière.
Tracing distribué
L’onglet Distributed tracing affiche les traces distribuées qui incluent la fonction Lambda monitorée. Pour plus de détails, voir tracing distribué.
Erreurs
L’onglet Errors affiche les erreurs et les exceptions pour votre fonction Lambda. Vous pouvez filtrer par taux d’erreur, pourcentage d’erreur, ou classe d’erreur, et explorer les traces d’appels.
Logs
L’onglet Logs affiche les messages de log récents de votre fonction Lambda. Pour plus de détails, voir log.
Retour en arrière
Si vous devez ramener vos fonctions Lambda à l'expérience de monitoring serverless précédente, vous pouvez le faire en définissant la variable d'environnement NEW_RELIC_APM_LAMBDA_MODE sur false.