Conectar-se a uma fonte de dados Amazon OpenSearch Service
nota
Em espaços de trabalho compatíveis com a versão 9 ou mais recente, essa fonte de dados pode exigir a instalação do plug-in apropriado. Para obter mais informações, consulte Ampliar o espaço de trabalho com plug-ins.
Com o Amazon Managed Grafana, você pode adicionar o Amazon OpenSearch Service como fonte de dados usando a opção de configuração da AWS de fonte de dados no console do espaço de trabalho do Grafana. Essa fonte de dados é compatível com domínios do OpenSearch Service, que executam clusters do OpenSearch, bem como clusters legados do Elasticsearch.
A opção de configuração da AWS de fonte de dados simplifica a adição do OpenSearch Service como fonte de dados ao descobrir as contas existentes do OpenSearch Service e gerencia a configuração das credenciais de autenticação necessárias para acessá-lo. Você pode usar esse método para configurar a autenticação e adicionar o OpenSearch Service como fonte de dados, ou você pode configurar manualmente a fonte de dados e as credenciais de autenticação necessárias usando o mesmo método que usaria em um servidor Grafana autogerenciado.
A fonte de dados OpenSearch Service é compatível com piped processing language (PPL). Para obter mais informações sobre a PPL, consulte Consulta de dados do Amazon OpenSearch Service usando Piped Processing Language.
Você pode usar a fonte de dados OpenSearch Service para realizar vários tipos de consultas simples ou complexas do OpenSearch a fim de visualizar logs ou métricas armazenados no OpenSearch. Você também pode anotar os grafos com eventos de logs armazenados no OpenSearch.
Tópicos
Configurações do OpenSearch Service
| Nome | Descrição |
|---|---|
Name
|
O nome da fonte de dados. É assim que você vê a fonte de dados nos painéis e consultas. |
Default
|
Fonte de dados padrão significa que ela será pré-selecionada para novos painéis. |
Url
|
O endpoint do domínio do OpenSearch Service. O endpoint assumirá o seguinte formato: https://search-my-domain.us-east-1.es.amazonaws.com. |
Access
|
Servidor (padrão) = o URL deve estar acessível no backend e no servidor Grafana. Navegador = o URL deve estar acessível no navegador. |
O modo de acesso controla como as solicitações à fonte de dados serão tratadas. O servidor deverá ser a forma preferencial se nada mais for declarado.
Modo de acesso ao servidor (padrão)
Todas as solicitações são feitas do navegador para o backend ou servidor Grafana, que encaminha as solicitações para a fonte de dados, contornando possíveis requisitos de compartilhamento de recursos entre origens (CORS). Se você selecionar esse modo de acesso, o URL deverá estar acessível no backend ou servidor Grafana.
Acesso (direto) ao navegador
O Amazon Managed Grafana não é compatível com o acesso direto ao navegador.
Configurações de índice
Aqui você pode especificar um padrão para o time field e especificar o nome do índice do OpenSearch. Você pode usar um padrão de hora para o nome do índice ou um caractere curinga.
Versão do OpenSearch e Elasticsearch
Especifique a versão do OpenSearch ou do Elasticsearch legada no menu suspenso de versão. A versão é importante porque há diferenças na forma como as consultas são compostas para cada versão. Atualmente, o Grafana é compatível com o OpenSearch 1.0.x. As versões compatíveis do Elasticsearch são 2.0+, 5.0+, 5.6+, 6.0+ e 7.0+. O valor 5.6+ significa a versão 5.6 ou superior, mas inferior à 6.0. O valor 6.0+ significa a versão 6.0 ou superior, mas inferior à 7.0. Finalmente, 7.0+ significa a versão 7.0 ou superior, mas inferior à 8.0.
Intervalo de tempo mínimo
Um limite mínimo para o grupo automático por intervalo de tempo. É recomendável definir a frequência de gravação, por exemplo, 1m se seus dados forem gravados a cada minuto. Essa opção também pode ser substituída e configurada em um painel de dashboard nas opções de fonte de dados. Esse valor deve ser formatado como um número seguido por um identificador de tempo válido, por exemplo, 1m (1 minuto) ou 30s (30 segundos). As fontes de identidade a seguir são compatíveis.
| Identificador | Description |
|---|---|
y
|
Ano |
M
|
Mês |
w
|
Semana |
d
|
Dia |
h
|
Hora |
m
|
Minuto |
s
|
Segundo |
ms
|
Milissegundo |
Logs
Dois parâmetros, Message field name e Level field
name, podem ser configurados opcionalmente na página de configurações da fonte de dados que determinam quais campos serão usados para mensagens de logs e níveis de logs ao visualizar os logs no Explore.
Por exemplo, se você usar uma configuração padrão do Filebeat para enviar logs para o OpenSearch Service, a configuração a seguir deve funcionar.
-
Nome do campo da mensagem: mensagem
-
Nome do campo de nível: fields.level
Links de dados
Os links de dados criam um link de um campo específico que pode ser acessado na visualização de logs no Explore.
Cada configuração de link de dados consiste no seguinte:
-
Campo: nome do campo usado pelo link de dados.
-
URL/consulta: se o link for externo, insira o URL completo do link. Se o link for um link interno, essa entrada servirá como consulta para a fonte de dados de destino. Em ambos os casos, você pode interpolar o valor do campo com o macro
${__value.raw }. -
Link interno: selecione esta opção se o link for interno ou externo. Se o link for interno, um seletor de fonte de dados permitirá que você selecione a fonte de dados de destino. Somente fontes de dados de rastreamento são compatíveis.
