Traducir el dashboard de Grafana al dashboard de New Relic

Convierta sus dashboard de Grafana existentes en dashboard nativos de New Relic utilizando nuestra API REST de traducción. Ya sea que busque consolidar sus herramientas de observabilidad, migrar toda su configuración de monitoreo a New Relic, o simplemente probar los dashboard de New Relic junto con su configuración de Grafana existente, esta API facilita el inicio.

Esta API utiliza la lógica de traducción de PromQL de New Relic para traducir tus consultas. Para ver una lista de las características y funciones de PromQL compatibles, consulta la guía de soporte de características de PromQL.

Requisitos previos

Antes de usar esta API, necesitará:

• Una clave de API de usuario de New Relic
• Tu ID de cuentade New Relic

Realice una solicitud a los extremos de API

Para traducir un dashboard de Grafana a un dashboard de New Relic, envíe una solicitud POST al extremo adecuado para su región con el dashboard que desea traducir en el cuerpo de la solicitud.

• A NOSOTROS: https://prometheus-api.newrelic.com/api/v1/translate/dashboard/grafana
• UE: https://prometheus-api.eu.newrelic.com/api/v1/translate/dashboard/grafana
• JP: https://prometheus-api.jp.newrelic.com/api/v1/translate/dashboard/grafana

Referencia API

Autenticación

Todas las llamadas API requieren una clave de API de usuario. Incluye esta clave en el encabezado api-key de tu solicitud.

Cuerpo de la solicitud

El cuerpo de la solicitud debe ser un objeto JSON con el siguiente formato:

{
  "accountId": int[optional],
  "dashboard": object[required]
}

Donde dashboard es el objeto JSON del dashboard de Grafana que desea traducir. El campo accountId es opcional — si se omite, el dashboard traducido consultará datos de la cuenta del usuario que realiza la solicitud.

Formato de respuesta

La API devuelve un objeto JSON que contiene el dashboard de New Relic traducido:

{
  "dashboard": {
    "name": "Translated Dashboard",
    "permissions": "PUBLIC_READ_WRITE",
    "pages": [...]
    }
}

Ejemplos

$
export NR_USER_KEY="YOUR_NEW_RELIC_USER_API_KEY"
$
export JSON_FILE="my_grafana_dashboard.json"
$
export TRANSLATOR_ENDPOINT="<TRANSLATOR_ENDPOINT_FOR_YOUR_REGION>" # (see API endpoints section above)
$

$
curl -s ${TRANSLATOR_ENDPOINT} \
>
-H "Content-Type: application/json" \
>
-H "api-key:${NR_USER_KEY}" \
>
-d "$(jq -c -n --slurpfile dashboard "${JSON_FILE}" '{dashboard: $dashboard[0]}')" \
>
| jq '.dashboard'

$
export NR_USER_KEY="YOUR_NEW_RELIC_USER_API_KEY"
$
export ACCOUNT_ID="YOUR_NEW_RELIC_STAGING_ACCOUNT_ID"
$
export JSON_FILE="my_grafana_dashboard.json"
$
export TRANSLATOR_ENDPOINT="<TRANSLATOR_ENDPOINT_FOR_YOUR_REGION>" # (see API endpoints section above)
$

$
curl -s ${TRANSLATOR_ENDPOINT} \
>
-H "Content-Type: application/json" \
>
-H "api-key:${NR_USER_KEY}" \
>
-d "$(jq -c -n --arg accountId "$ACCOUNT_ID" --slurpfile dashboard "$JSON_FILE" '{accountId: $accountId, dashboard: $dashboard[0]}')" \
>
| jq '.dashboard'

$
export NR_USER_KEY="YOUR_NEW_RELIC_USER_API_KEY"
$
export ACCOUNT_ID="YOUR_NEW_RELIC_STAGING_ACCOUNT_ID"
$
export JSON_FILE="my_grafana_dashboard.json"
$
export TRANSLATOR_ENDPOINT="<TRANSLATOR_ENDPOINT_FOR_YOUR_REGION>" # (see API endpoints section above)
$
export NERDGRAPH_ENDPOINT="<NERDGRAPH_ENDPOINT_FOR_YOUR_REGION>"
$

$
NR_DASHBOARD=$(curl -s ${TRANSLATOR_ENDPOINT} \
>
-H "Content-Type: application/json" \
>
-H "api-key:${NR_USER_KEY}" \
>
-d "$(jq -c -n --arg accountId "$ACCOUNT_ID" --slurpfile dashboard "$JSON_FILE" '{accountId: $accountId, dashboard: $dashboard[0]}')" \
>
| jq '.dashboard')
$

$

$
curl -X POST ${NERDGRAPH_ENDPOINT} \
>
-H "Content-Type: application/json" \
>
-H "API-Key: ${NR_USER_KEY}" \
>
-d '{
$
"query": "mutation($accountId: Int!, $dashboard: DashboardInput!) { dashboardCreate(accountId: $accountId, dashboard: $dashboard) { entityResult { guid name } errors { description } } }",
$
"variables": {
$
"accountId": '${ACCOUNT_ID}',
$
"dashboard": '${NR_DASHBOARD}'
$
}
$
}'

Resolución de errores de traducción

Cuando el traductor encuentra problemas que impiden la traducción completa de un widget o consulta, crea "Action Items" — widget especiales de Markdown que explican qué salió mal y sugieren correcciones.

Tipos de widget de Grafana y New Relic

La siguiente es una lista de los tipos de widgets de Grafana que admitimos y sus correspondientes tipos de widgets de New Relic.