Si vous avez décidé de créer une application personnalisée ou de modifier l'une de nos applications open source, vous avez besoin de quelques outils essentiels :
- L'interface de ligne de commande (CLI) de New Relic.
- Une clé API, que vous obtenez lorsque vous téléchargez la CLI.
En fonction de ce que vous souhaitez faire avec votre application, vous devrez peut-être effectuer des réglages et des configuration supplémentaires. Ce guide couvre :
- Téléchargement de la CLI New Relic pour créer ou modifier des applications
- Contribuer au contenu de ce site Web
Avant de commencer
Avant de commencer, nous vous recommandons de lire d’abord ce qui concerne les autorisations.
Pour commencer à construire, vous devez avoir :
- Un compte github . Bien que cela ne soit pas strictement nécessaire pour créer des applications, un compte GitHub vous permet de télécharger et de personnaliser nos applications open source et de contribuer à un projet open source.
- Un compte développeurs New Relic. Si vous n'en avez pas déjà un, vous pouvez obtenir un compte d'essai gratuit pour développer des applications New Relic.
- npm. Si vous avez installé Node.js, vous disposez déjà de
npm, qui permet de partager, réutiliser et mettre à jour le code JavaScript. Ceci est nécessaire pour travailler avec les composants React qui constituent le framework des applications New Relic et de ce site Web.
Une note sur le support
Créer une application New Relic est identique à créer n'importe quelle application JavaScript/React. Nous offrons un support pour vous aider avec nos outils de construction (notre bibliothèque CLI et SDK). Cependant, nous n'offrons pas d'assistance pour les questions ou problèmes de codage JavaScript ou React de base.
Pour les questions et réponses courantes sur la construction, consultez la page Explorers Hub sur la construction sur New Relic.
Conseil
Utilisez l’ extension New Relic VSCode ou le pack d’extension New Relic VSCode pour créer vos applications.
Préparez-vous à créer ou à modifier des applications
Téléchargez la CLI et la clé API
Sur la page Build New Relic applications, suivez les étapes du Quick start pour télécharger.
Ces six étapes de démarrage rapide vous permettent d'obtenir une clé API à utiliser pour le développement d'applications et la CLI New Relic pour créer et déployer des applications. À la fin du démarrage rapide, vous disposez d'un projet composé des éléments suivants :
- Un Nerdpack. Le package contenant tous les fichiers requis par votre application. Il contient deux types de fichiers que vous personnalisez pour créer votre application : les Nerdlets et le lanceur.
- Un ou plusieurs fichiers Nerdlet . Une vue ou une fenêtre d'interface utilisateur spécifique. Un Nerdlet est un package JavaScript React qui comprend un fichier
index.js, unstylesheetet un fichierconfigau format JSON. Il peut contenir n'importe quelle fonctionnalité JS (graphiques, champs interactifs, info-bulles, etc.). - Un fichier
launcher: il s'agit de la base du lanceur, qui est utilisé pour ouvrir votre application à partir de New Relic après avoir publié votre application.
Commencer à construire
Si vous êtes prêt à coder, cd dans votre Nerdpack et commencez.
Si vous souhaitez en savoir plus sur la création d’applications, essayez ces guides étape par étape :
- Créer une application « Hello, World ! » montre comment créer une petite application, la publier sur New Relic et la partager avec d'autres en y abonnant des comptes.
- La carte des pages vues par région vous guide à travers les étapes de création de l'une de nos applications open source populaires. Vous apprenez à ajouter une requête personnalisée à une application et à l'afficher dans un tableau, puis à ajouter ces données à une carte.
Contribuer au site developer.newrelic.com
Ce site est open source et nous aimerions avoir votre avis. Créez une demande de tirage si vous voyez une erreur que vous savez comment corriger. Envoyez-nous un problème GitHub si vous voyez des lacunes de contenu sur lesquelles vous souhaitez que nous travaillions. Ou rédigez un tout nouveau guide si vous en avez un que vous souhaitez partager. Lisez la suite pour savoir comment.
Forkez le référentiel GitHub developer-website (dépôt)
Le forking du référentiel vous permet de travailler sur votre propre copie des fichiers developer.newrelic.com , et de construire le site localement. Cela nous permet également de gérer plus facilement les demandes de tirage entrantes.
Accédez à la page du site Web des développeurs dans GitHub.
Sélectionnez le bouton Fork en haut à droite de la page.
Choisissez le compte vers lequel vous souhaitez effectuer le fork et attendez quelques secondes pendant que le fork est créé.
Synchronisez régulièrement pour maintenir votre fork à jour avec les modifications et les ajouts apportés à la branche principale en amont.
Faire une demande de fonctionnalité ou de documentation
- Sur n’importe quelle page, sélectionnez le bouton GitHub en haut de la page.
- Sélectionnez le type de changement que vous souhaitez.
- Remplissez le formulaire GitHub.
Contribuer à un nouveau guide
Consultez nos directives pour les contributeurs, qui vous guideront tout au long du processus.