Salesforce - Amazon Managed Grafana

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Salesforce

A fonte de dados do Salesforce permite que você visualize dados do Salesforce no Amazon Managed Grafana.

Para usar essa fonte de dados, você deve ter uma conta do Salesforce e um aplicativo conectado ao Salesforce.

Limitações conhecidas

  • Filtros ad-hoc ainda não são suportados.

  • Atualmente, somente consultas SOQL e dados acessíveis via SOQL são suportados. Os formatos de consulta SOSL e SAQL ainda não têm suporte.

Configurações necessárias

São necessárias as seguintes configurações.

nota

Atualmente, o plug-in usa o fluxo de nome de usuário e senha do OAuth 2.0. O URL de retorno de chamada necessário no aplicativo conectado não é usado. Assim, você pode configurá-lo para qualquer URL válido.

Name (Nome) Descrição
Enable OAuth settings Você deve verificar isso para habilitar o OAuth.
Callback URL Não é usado neste plug-in, então você pode especificar qualquer URL válido.
Selected OAuth Scopes (minimum requirements) Acesse e gerencie seus dados (api).
Require Secret for Refresh Token Flow Você pode habilitar ou desabilitar isso.

Adicionar a fonte de dados

  1. Abra o console do Grafana no espaço de trabalho Amazon Managed Grafana e verifique se você está logado.

  2. No menu lateral em Configuração (o ícone de engrenagem), escolha Fontes de dados.

  3. Escolha Adicionar fonte de dados.

    nota

    Se você não vê o link Fontes de dados no menu lateral, isso significa que seu usuário atual não tem aAdmin função.

  4. Selecione Salesforce na lista de fontes de dados.

  5. Insira as seguintes informações:

    • Em Nome de usuário, insira o nome de usuário da conta do Salesforce que você deseja usar para se conectar e consultar o Salesforce.

    • Em Senha, digite a senha desse usuário.

    • Em Token de Segurança, insira o token de segurança desse usuário.

    • Em Chave do consumidor, insira Uma chave de consumidor para se conectar ao Salesforce. Você pode obter isso em seu aplicativo Salesforce Connected.

    • Em Consumer Secret, insira Um segredo do consumidor para se conectar ao Salesforce. Você pode obter isso em seu aplicativo Salesforce Connected.

    • Em Usar sandbox, selecione essa opção se quiser usar uma sandbox do Salesforce.

Consulte a fonte de dados do Salesforce

O editor de consultas suporta os modos Query Builder e SOQL Editor. SOQL significa Salesforce Object Query Language.

Construtor de consultas (Construtor SOQL)

O Query Builder é uma interface amigável para criar consultas SOQL. Se você não estiver familiarizado com a escrita de consultas SOQL, poderá usar esse modo para criar o SOQL para consultar objetos do Salesforce. O campo FROM no criador de consultas se refere à entidade ou entidades no Salesforce. Você precisa selecionar o campo FROM antes de qualquer outra operação no construtor de consultas. Depois de escolher o campo FROM, você precisa escolher o modo construtor. O SOQL Builder oferece suporte para aos seguintes modos no momento.

  • List— Liste os itens com seus campos da tabela/Salesforce selecionada. Use esse modo para obter resultados como “Mostre-me a lista de oportunidades criadas neste trimestre fiscal, juntamente com seu nome, valor e estágio”.

  • Aggregate— Agregue os itens em uma entidade. Use esse modo para obter resultados como “Conte as oportunidades criadas no mês passado”. ou “Qual é o valor total das oportunidades agrupadas pelo nome artístico?”

  • Trend— Exibir os resultados agregados ao longo do tempo. Use esse modo para obter resultados como “Conte o número de oportunidades até” CreatedDate. ou “Qual é a soma total do valor agrupada pelas datas de encerramento das oportunidades”.

Depois de escolher o modoEntity/FROM e no editor de consultas, crie sua consulta usando as opções a seguir.

Campos Aplicável a Descrições
SELECT ALL Selecione a lista de campos que você deseja ver. Para a visualização agregada ou de tendência, selecione também como você deseja agregar os valores.
WHERE ALL (Opcional) Especifique as condições do filtro. Os resultados são filtrados com base nas condições que você seleciona.
ORDER BY LISTA, AGREGADO (Opcional) Selecione o nome do campo e a ordem de classificação que você deseja para os resultados.
LIMIT LISTA, AGREGADO (Opcional) Limite o número de resultados retornados. O padrão é 100.
GROUP BY AGGREGATE (Opcional) Selecione o campo se quiser dividir o valor agregado por qualquer campo específico.
CAMPO DE TEMPO TENDÊNCIA Especifique o campo de data pelo qual você deseja agrupar seus resultados. Os resultados são filtrados com base no intervalo do seletor de tempo do Grafana.

Ao configurar os campos anteriores no editor de consultas, você também verá uma prévia do SOQL gerado abaixo do editor de consultas. Se você estiver bloqueado com alguma limitação no criador de consultas, poderá alternar com segurança para o Editor SOQL, onde poderá personalizar a consulta SOQL gerada.

Editor do SOQL

O editor SOQL bruto oferece a opção de consultar objetos do Salesforce por meio de uma consulta SOQL bruta. O editor SOQL fornece sugestões de preenchimento automático, como entidades disponíveis por tabela e campos correspondentes. Use Ctrl+Espaço após SELECT ou WHERE para ver as entidades disponíveis por tabela. Você pode ver os campos disponíveis se inserir um ponto após o nome da entidade.

Atalhos

Use CTRL + SPACE para mostrar o preenchimento do código, que mostra as opções contextuais disponíveis.

O CMD + S executa a consulta.

Consulta como série temporal

Faça uma consulta de série temporal aliando um campo de data para hora e um campo métrico para métrica e, em seguida, agrupando por métrica e data. Veja um exemplo a seguir.

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

Macros

Para filtrar pelo intervalo de tempo do painel, você pode usar macros em suas consultas SOQL:

  • $__timeFrom— Será substituído pelo início da seleção de horário atualmente ativa convertida para o tipo detime dados.

  • $__timeTo— Será substituído até o final da seleção de tempo atualmente ativa convertida para o tipo detime dados.

  • $__quarterStart— O início do trimestre fiscal (derivado das configurações do ano SalesForce fiscal).

  • $__quarterEnd— O final do trimestre fiscal (derivado das configurações do ano SalesForce fiscal).

SELECT UserId, LoginTime from LoginHistory where LoginTime > $__timeFrom

Modelos e variáveis

Para adicionar uma nova variável de consulta do Salesforce, consulteAdicionar uma variável de consulta. Use sua fonte de dados do Salesforce como sua fonte de dados. Você pode usar qualquer consulta SOQL aqui.

Se você quiser usar pares de nome/valor, por exemplo, um ID de usuário e um nome de usuário, retorne dois campos da sua consulta SOQL. O primeiro campo será usado como ID. Talvez você queira fazer isso quando quiser filtrar por chave (ID, etc.) em seu editor de consultas SOQL.

Use a variável em suas consultas SOQL usando a sintaxe de variável. Para obter mais informações, consulte Sintaxe de variáveis.