Salesforce

nota

Esta fuente de datos es solo para Grafana Enterprise. Para obtener más información, consulte Gestione el acceso a los complementos empresariales.

Además, en los espacios de trabajo compatibles con la versión 9 o posterior, es posible que esta fuente de datos requiera la instalación del complemento adecuado. Para obtener más información, consulte Plugins de Grafana.

La fuente de datos de Salesforce te permite visualizar los datos de Salesforce en Amazon Managed Grafana.

Para utilizar esta fuente de datos, debe tener una cuenta de Salesforce y una aplicación Salesforce Connected.

Limitaciones conocidas

• Los filtros ad hoc aún no son compatibles.

• Actualmente, solo se admiten las consultas SOQL y los datos a los que se puede acceder a través de SOQL. Los formatos de consulta SOSL y SAQL aún no son compatibles.

Ajustes necesarios

Se requieren los siguientes ajustes.

nota

El complemento utiliza actualmente el flujo de nombre de usuario y contraseña de OAuth 2.0. No se utiliza la URL de devolución de llamada requerida en la aplicación conectada. Por lo tanto, puede configurarla en cualquier URL válida.

Nombre	Descripción
Enable OAuth settings	Debes marcarlo para habilitar OAuth.
Callback URL	No se usa en este complemento, por lo que puedes especificar cualquier URL válida.
Selected OAuth Scopes (minimum requirements)	Accede a tus datos y adminístralos (api).
Require Secret for Refresh Token Flow	Puede activar o desactivar esta opción.

Añadir la fuente de datos

1. Abre la consola de Grafana en el espacio de trabajo de Grafana gestionado por Amazon y asegúrate de haber iniciado sesión.

2. En el menú lateral, en Configuración (el icono con forma de engranaje), selecciona Fuentes de datos.

3. Elija Agregar origen de datos.

   nota

   Si no ves el enlace Fuentes de datos en el menú lateral, significa que tu usuario actual no tiene el Admin rol.

4. Selecciona Salesforce de la lista de fuentes de datos.

5. Introduzca la información siguiente:

   • En Nombre de usuario, introduzca el nombre de usuario de la cuenta de Salesforce que quiere usar para conectarse y consultar Salesforce.

   • En Contraseña, introduzca la contraseña de ese usuario.

   • Para el token de seguridad, introduzca el token de seguridad de ese usuario.

   • En Consumer Key, introduzca una clave de consumidor para conectarse a Salesforce. Puede obtenerla desde su aplicación Salesforce Connected.

   • En Consumer Secret, introduzca A Consumer Secrete para conectarse a Salesforce. Puede obtenerlo desde su aplicación Salesforce Connected.

   • En Use Sandbox, seleccione esta opción si quiere usar un sandbox de Salesforce.

Consulte la fuente de datos de Salesforce

El editor de consultas admite los modos Query Builder y SOQL Editor. SOQL son las siglas de Salesforce Object Query Language.

Generador de consultas (SOQL Builder)

Query Builder es una interfaz fácil de usar para crear consultas SOQL. Si no está familiarizado con la escritura de consultas de SOQL, puede usar este modo para crear el SOQL para consultar objetos de Salesforce. El campo FROM del generador de consultas hace referencia a la entidad o entidades de Salesforce. Debe seleccionar el campo FROM antes de realizar cualquier otra operación en el generador de consultas. Después de elegir el campo FROM, debe elegir el modo de creación. Actualmente, SOQL Builder admite los siguientes modos.

• List— Listar los elementos con sus campos de la tabla/fuerza de ventas seleccionada. Utilice este modo para obtener resultados como: «Muéstreme una lista de las oportunidades creadas en este trimestre fiscal junto con su nombre, valor y etapa».

• Aggregate— Agregue los elementos de una entidad. Utilice este modo para obtener resultados como «Cuenta las oportunidades creadas el mes pasado». o «¿Cuál es el valor total de las oportunidades agrupadas por su nombre artístico?»

• Trend— Mostrar los resultados agregados a lo largo del tiempo. Usa este modo para obtener resultados como «Cuenta el número de oportunidades por» CreatedDate. o «¿Cuál es la suma total del valor agrupada por las fechas de cierre de las oportunidades?»

Tras elegir el modo Entity/FROM y el modo en el editor de consultas, cree la consulta con las siguientes opciones.

Campos	Aplicable a	Descripciones
SELECT	ALL	Seleccione la lista de campos que desee ver. Para la vista agregada o de tendencias, seleccione también cómo desea agregar los valores.
WHERE	ALL	(Opcional) Especifique las condiciones del filtro. Los resultados se filtran en función de las condiciones que seleccione.
ORDER BY	LISTA, AGREGADO	(Opcional) Seleccione el nombre del campo y el orden de clasificación que desee para los resultados.
LIMIT	LISTA, AGREGADO	(Opcional) Limite el número de resultados devueltos. El valor predeterminado es 100.
GROUP BY	AGGREGATE	(Opcional) Seleccione el campo si desea dividir el valor agregado por un campo específico.
CAMPO DE TIEMPO	TENDENCIA	Especifique el campo de fecha por el que desea agrupar los resultados. Los resultados se filtran según el rango del selector de tiempo de Grafana.

Al configurar los campos anteriores en el editor de consultas, también verá una vista previa del SOQL generado debajo del editor de consultas. Si tiene alguna limitación en el generador de consultas, puede cambiar sin problemas al editor de SOQL, donde puede personalizar la consulta de SOQL generada.

Editor SOQL

El editor SOQL sin procesar ofrece la opción de consultar objetos de Salesforce mediante una consulta SOQL sin procesar. El editor SOQL proporciona sugerencias de autocompletado, como las entidades disponibles por tabla y los campos correspondientes. Use Ctrl+Espacio después de SELECCIONAR o DÓNDE para ver las entidades disponibles por tabla. Puede ver los campos disponibles si introduce un punto después del nombre de la entidad.

Atajos

Use CTRL + SPACE para mostrar la finalización del código, lo que muestra las opciones contextuales disponibles.

CMD + S ejecuta la consulta.

La consulta como serie temporal

Para realizar una consulta de series temporales, asigne un alias a un campo de fecha y un campo de métrica a métrica y, a continuación, agrupe por métrica y fecha. A continuación, se muestra un ejemplo:

SELECT sum(Amount) amount, CloseDate time, Type metric from Opportunity
group by Type, CloseDate

Macros

Para filtrar por el rango de tiempo del panel, puede usar macros en sus consultas de SOQL:

• $__timeFrom— Se sustituirá por el inicio de la selección de tiempo actualmente activa convertida al tipo de time datos.

• $__timeTo— Se sustituirá por el final de la selección de tiempo actualmente activa convertida al tipo de time datos.

• $__quarterStart— El inicio del trimestre fiscal (derivado de la configuración del año SalesForce fiscal).

• $__quarterEnd— El final del trimestre fiscal (derivado de la configuración del año SalesForce fiscal).

SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom

Plantillas y variables

Para añadir una nueva variable de consulta de Salesforce, consulteAñadir una variable de consulta. Utilice su fuente de datos de Salesforce como fuente de datos. Aquí puede utilizar cualquier consulta de SOQL.

Si desea utilizar pares de nombre/valor, por ejemplo, un identificador de usuario y un nombre de usuario, devuelva dos campos de la consulta de SOQL. El primer campo se usará como ID. Haga esto cuando desee filtrar por clave (ID, etc.) en su editor de consultas SOQL.

Utilice la variable en sus consultas de SOQL mediante la sintaxis de variables. Para obtener más información, consulte Sintaxis de variables.