Tutoriel NerdGraph : créer, mettre à jour et révoquer les URL dashboard de partage public

1. Accédez à l'explorateur d'API NerdGraph.
2. Construisez un graphe appelé d'API en utilisant les détails suivants :

• Mutation: dashboardCreateLiveUrl

• GUID: Le guide d'entité du dashboard

• Options(facultatif) : la période en secondes pendant laquelle l'URL doit être active

  • Valeur minimale: 300 secondes (5 minutes)
  • Valeur maximale: 631152000 secondes (20 ans)
  • Valeur par défaut: 2592000 secondes (30 jours)

• Réponse: url

  mutation CreatePublicLink {
    dashboardCreateLiveUrl(
      guid: "YOUR_DASHBOARD_GUID"
      options: { ttl: "updated duration in seconds" }
    ) {
      url
    }
  }

  Copier

  L'URL dashboard en direct apparaît dans la réponse. Il s'agit d'une URL publique, vous pouvez donc la partager avec n'importe qui.

  https://share.newrelic.com/dashboard/PUBLIC_LINK_ID

  Copier

  Le PUBLIC_LINK_ID est l'ID du dashboard partagé. Vous pouvez l'utiliser pour mettre à jour ou révoquer l'URL dashboard partagé via NerdGraph.

  Important

  Toute mise à jour de contenu dans le dashboard sur la plateforme New Relic se reflète dans la page dashboard partagé.

Assurez-vous que vous disposez des autorisations pour modifier la configuration du dashboard partagé.

Pour mettre à jour la période pendant laquelle l'URL doit être active :

1. Accédez à l'explorateur d'API NerdGraph.
2. Construisez un graphe appelé d'API en utilisant les détails suivants :

• Mutation: dashboardUpdateLiveUrl

• ID: l’ID du dashboard partagé (copiez-le à partir de l’URL dashboard partagé).

• Options: la période de temps mise à jour en secondes

  • Valeur minimale: 300 secondes (5 minutes)
  • Valeur maximale: 631152000 secondes (20 ans)
  • Valeur par défaut: 2592000 secondes (30 jours)

  mutation UpdatePublicLink {
    dashboardUpdateLiveUrl(
      id: "enter the public link ID"
      options: { ttl: "updated duration in seconds" }
    ) {
      title
      url
    }
  }

  Copier

  L'URL apparaît dans la réponse comme suit. Désormais, l'URL restera active pendant la période mise à jour.

  https://share.newrelic.com/dashboard/PUBLIC_LINK_ID

  Copier

En fonction des autorisations dont vous disposez, vous pouvez révoquer uniquement les URL que vous avez créées ou toutes les URL créées par l'utilisateur dans le compte. Pour révoquer une URL dashboard partagée :

1. Accédez à l'explorateur d'API NerdGraph.
2. Construisez un graphe appelé d'API en utilisant les détails suivants :

• Mutation: dashboardRevokeLiveUrl

• ID: l’ID du dashboard partagé (copiez-le à partir de l’URL dashboard partagé).

  mutation {
    dashboardRevokeLiveUrl(id: "PUBLIC_LINK_ID") {
      id
    }
  }

  Copier

  L'URL dashboard partagé est désormais révoquée et ne sera plus accessible. La réponse apparaît comme suit :

  {
    "data": {
      "dashboardRevokeLiveUrl": {
        "id": "PUBLIC_LINK_ID" //the one you passed to the mutation
      }
    }
  }

  Copier

En fonction des autorisations dont vous disposez, vous pouvez récupérer la liste des liens que vous avez créés, ou tous les liens créés par l'utilisateur dans le compte. Pour obtenir la liste des URL dashboard partagées :

1. Accédez à l'explorateur d'API NerdGraph.
2. Construisez un graphe appelé d'API en utilisant les détails suivants :

• Requête: dashboard

• Réponse: liveUrls

  {
    actor {
      user {
        name
      }
      dashboard {
        liveUrls(filter: { type: DASHBOARD }) {
          liveUrls {
            createdAt
            type
            uuid
          }
        }
      }
    }
  }

  Copier

  La liste des URL dashboard partagées apparaît en réponse.