Tutoriel NerdGraph : créer un rôle personnalisé pour les dashboards

Une carte de pointage sert de conteneur pour diverses règles qui évaluent collectivement le respect des normes définies. Les dashboards utilisent des règles pour monitorer la conformité entre différentes entités et équipes, identifier les domaines à améliorer et garantir l'alignement avec les exigences internes et externes. Ce document fournit des instructions sur la façon de créer et de gérer les dashboards et leurs règles dans New Relic.

Dans New Relic, deux types d'utilisateurs peuvent gérer les Scorecards :

Administrateur de produit de l'organisation
Rôle personnalisé utilisateur du dashboard

Cette section fournit des instructions sur l'utilisation des mutations NerdGraph GraphQL pour créer un rôle personnalisé pour la gestion des dashboards et des règles associées.

Pour créer un rôle personnalisé d'administrateur de dashboards, vous devez :

Rechercher les identifiants d'autorisation requis pour les dashboards
Récupérez votre identifiant d'organisation
Créer le rôle personnalisé pour l'administrateur des dashboards
Ajouter le rôle personnalisé à un groupe d'utilisateurs

Prérequis :

Exigences générales de NerdGraph
Vous devez être administrateur produit de l'organisation pour créer un rôle personnalisé.

Mutations

New Relic fournit diverses mutations NerdGraph pour créer un rôle personnalisé pour les gestionnaires de dashboards.

Utilisez la requête customerAdministration pour récupérer une liste de capacités, leurs ID d'autorisation et les informations connexes.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`eq`	Chaîne	Oui	Définissez la valeur sur `organization` pour récupérer les autorisations pour les tableaux de bord.

paramètres

Type de données

Est-ce obligatoire ?

Description

eq

Chaîne

Oui

Définissez la valeur sur

organization

pour récupérer les autorisations pour les tableaux de bord.

Demande d'échantillon

{
  customerAdministration {
    permissions(filter: { scope: { eq: "organization" } }) {
      items {
        feature
        category
        id
        product
      }
    }
  }
}

Exemple de réponse

{
  "data": {
    "customerAdministration": {
      "permissions": {
        "items": [
          {
            "category": "READ",
            "feature": "Scorecards Rules",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MANAGE",
            "feature": "Scorecards Rules",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "READ",
            "feature": "Scorecards",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MANAGE",
            "feature": "Scorecards",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "READ",
            "feature": "Teams",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "OTHER",
            "feature": "Teams",
            "id": "xxxxxx",
            "product": "New Relic One"
          },
          {
            "category": "DELETE",
            "feature": "Teams",
            "id": "xxxxx",
            "product": "New Relic One"
          },
          {
            "category": "MODIFY",
            "feature": "Teams",
            "id": "xxxxxx",
            "product": "New Relic One"
          }
        ]
      }
    }
  }
}

Copiez et collez les informations relatives aux Scorecards dans un fichier texte correspondant aux critères suivants :

category: MANAGE
"feature"``: "Scorecards" ou "Scorecards Rules"

Par exemple, dans la réponse précédente, ce qui suit correspond aux critères :

({
  "category": "MANAGE",
  "feature": "Scorecards Rules",
  "id": "xxxxx",
  "product": "New Relic One"
},
{
  "category": "MANAGE",
  "feature": "Scorecards",
  "id": "xxxxx",
  "product": "New Relic One"
})

Récupérez l'identifiant de votre organisation pour l'utiliser dans diverses mutations ultérieures.

Demande d'échantillon

{
  actor {
    organization {
      id
    }
  }
}

Exemple de réponse

{
  "data": {
    "actor": {
      "organization": {
        "id": "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
      }
    }
  }
}

Copiez l’ID de l’organisation et conservez-le pour créer un rôle.

Exécutez la mutation customRoleCreate pour créer votre propre rôle personnalisé.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`id`	Chaîne	Oui	L’ID de l’organisation copié à l’étape précédente.
`type`	Chaîne	Oui	Définissez le type sur `organization` .
`name`	Chaîne	Oui	Le nom du rôle.
`permissionIds`	[Int]	Oui	Liste des identifiants de la fonctionnalité identifiée à l'aide de la requête `customerAdministration` pour les tableaux de bord (Scorecards) et les règles des tableaux de bord (Scorecards).
`scope`	Chaîne	Oui	Définissez la portée sur `organization` .

Demande d'échantillon

mutation {
  customRoleCreate(
    container: {
      id: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
      type: "organization"
    }
    name: "Scorecards manager"
    permissionIds: [xxxxx, xxxxx]
    scope: "organization"
  ) {
    id
  }
}

Exemple de réponse

{
  "data": {
    "customRoleCreate": {
      "id": 9999999
    }
  }
}

paramètres	Type de données	Description
`id`	Int	L'ID de rôle personnalisé. Copiez et conservez cette pièce d'identité pour une utilisation ultérieure.

Après avoir créé le rôle personnalisé, vous devez associer ce rôle à un groupe d'utilisateurs sur la plateforme New Relic.

Récupérer l'ID du groupe

Vous pouvez utiliser la requête customerAdministration pour récupérer la liste des identifiants de groupe.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`id`	Chaîne	Oui	L’ID de l’organisation copié à l’étape précédente.

Demande d'échantillon

{
  customerAdministration {
    groups(
      filter: {
        organizationId: { eq: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX" }
      }
    ) {
      nextCursor
      items {
        id
        name
        users {
          items {
            id
            email
          }
        }
      }
    }
  }
}

Dans la liste affichée des ID de groupe, copiez l’ID de groupe souhaité pour associer le rôle de dashboard personnalisé que vous avez créé précédemment.

Ajouter la règle à un groupe d'utilisateurs

Vous pouvez utiliser la mutation authorizationManagementGrantAccess pour ajouter le rôle à un groupe d'utilisateurs.

Paramètres d'entrée

paramètres	Type de données	Est-ce obligatoire ?	Description
`roleId`	Chaîne	Oui	L'ID de rôle personnalisé créé dans la section Rôle personnalisé.
`groupId`	Chaîne	Non	L’ID de groupe récupéré à l’étape précédente.

Demande d'échantillon

mutation {
  authorizationManagementGrantAccess(
    grantAccessOptions: {
      organizationAccessGrants: { roleId: "99999999" }
      groupId: "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX"
    }
  ) {
    roles {
      id
      name
      organizationId
      roleId
      groupId
      displayName
    }
  }
}

Exemple de réponse

{
  "data": {
    "authorizationManagementGrantAccess": {
      "roles": [
        {
          "displayName": "Scorecards manager",
          "groupId": null,
          "id": "99999999",
          "name": "scorecards_manager",
          "organizationId": "xxx****xxx-xx**00**-xxx-x*x*-xx**XXX**XX",
          "roleId": 99999
        }
      ]
    }
  }
}

Découvrez le nouveau rôle dans la plateforme New Relic

Vous pouvez vérifier si le rôle de la carte de score se reflète dans la plateforme New Relic.

Pour vérifier le rôle :

Connectez-vous à votre compte New Relic.
Cliquez sur votre nom en bas à gauche.
Allez dans Administration > Access Management.
Cliquez sur l'onglet Subventions : vous pouvez voir le rôle personnalisé que vous avez créé dans la liste des rôles :

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : créer un rôle personnalisé pour les dashboards

Mutations

Rechercher les identifiants d'autorisation requis pour les dashboards

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Récupérez votre identifiant d'organisation

Demande d'échantillon

Exemple de réponse

Créer un rôle personnalisé

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Ajouter un rôle personnalisé à un groupe d'utilisateurs

Récupérer l'ID du groupe

Paramètres d'entrée

Demande d'échantillon

Ajouter la règle à un groupe d'utilisateurs

Paramètres d'entrée

Demande d'échantillon

Exemple de réponse

Découvrez le nouveau rôle dans la plateforme New Relic

Cette traduction automatique est fournie pour votre commodité.

Tutoriel NerdGraph : créer un rôle personnalisé pour les dashboards

Mutations .css-21sua1{background:none;border:none;width:0;padding:0;}

Récupérez votre identifiant d'organisation

Créer un rôle personnalisé

Ajouter un rôle personnalisé à un groupe d'utilisateurs

Découvrez le nouveau rôle dans la plateforme New Relic

Mutations