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

Aperçu

Nous travaillons toujours sur cette fonctionnalité, mais nous aimerions que vous l'essayiez !

Cette fonctionnalité est actuellement fournie dans le cadre d'un programme d'aperçu conformément à nos politiques de pré-sortie.

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 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 :

Récupérer toutes les capacités de l'organisation
Récupérez votre identifiant d'organisation
Rechercher les identifiants d'autorisation requis pour les dashboards
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 un administrateur d’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 mutation customerAdministration pour récupérer une liste de capacités, leurs identifiants d'autorisation et les informations associées.

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 le rôle des dashboards.

paramètres

Type de données

Est-ce obligatoire ?

Description

eq

Chaîne

Oui

Définissez la valeur sur

organization

pour récupérer le rôle des dashboards.

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.
`PermissionId`	Int	Oui	Répertoriez les ID de la fonctionnalité récupérée à l'aide de mutations `customerAdministration` pour les règles Scorecards et 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 mutation customerAdministration pour récupérer la liste des ID 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.

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

Aperçu

Mutations

Récupérer les capacités à l'échelle de l'organisation

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

Aperçu

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