

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á.

# Conecte-se a uma fonte OpenSearch de dados do Amazon Service
<a name="using-Amazon-OpenSearch-in-AMG"></a>

**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](grafana-plugins.md).

Com o Amazon Managed Grafana, você pode adicionar o Amazon OpenSearch Service como fonte de dados usando a opção de configuração da fonte de AWS dados no console do espaço de trabalho do Grafana. Essa fonte de dados é compatível com domínios OpenSearch de serviço, que executam OpenSearch clusters, bem como clusters legados do Elasticsearch.

A opção de configuração da fonte de AWS dados simplifica a adição do OpenSearch Serviço como fonte de dados ao descobrir suas contas de OpenSearch Serviço existentes e gerencia a configuração das credenciais de autenticação que são necessárias para acessar. OpenSearch Você pode usar esse método para configurar a autenticação e adicionar o OpenSearch Serviço como fonte de dados ou pode configurar manualmente a fonte de dados e as credenciais de autenticação necessárias usando o mesmo método que você usaria em um servidor Grafana autogerenciado.

A fonte OpenSearch de dados do Serviço oferece suporte à linguagem de processamento canalizada (PPL). Para obter mais informações sobre PPL, consulte [Consultar dados do Amazon OpenSearch Service usando a linguagem de processamento canalizada](https://docs.aws.amazon.com/opensearch-service/latest/developerguide/ppl-support.html). 

Você pode usar a fonte OpenSearch de dados do Serviço para realizar vários tipos de OpenSearch consultas simples ou complexas a fim de visualizar registros ou métricas armazenados em. OpenSearch Você também pode anotar seus gráficos com eventos de log armazenados em. OpenSearch 

**Topics**
+ [Use a configuração da fonte de AWS dados para adicionar o OpenSearch Serviço como fonte de dados](ES-adding-AWS-config.md)
+ [Adicione manualmente o Amazon OpenSearch Service como fonte de dados](ES-adding-the-data-source.md)
+ [OpenSearch Configurações do serviço](#ES-settings)
+ [Usando a fonte de dados OpenSearch do Amazon Service](ES-use-datasource.md)
+ [Amazon OpenSearch Service sem servidor](datasources-opensearch-serverless.md)
+ [Compatibilidade com rastreamentos](datasources-opensearch-traces.md)

## OpenSearch Configurações do serviço
<a name="ES-settings"></a>


|  Name (Nome)  |  Description  | 
| --- | --- | 
|  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 seu domínio de OpenSearch serviço. O endpoint tem 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)
<a name="ES-server-access-mode-default"></a>

 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
<a name="ES-browser-direct-access"></a>

O Amazon Managed Grafana não é compatível com o acesso direto ao navegador.

### Configurações de índice
<a name="ES-index-settings"></a>

 Aqui você pode especificar um padrão para o `time field` e especificar o nome do seu OpenSearch índice. Você pode usar um padrão de hora para o nome do índice ou um caractere curinga. 

### OpenSearch/Versão Elasticsearch
<a name="OpenSearch-version"></a>

Especifique sua versão OpenSearch ou a versão antiga do Elasticsearch no menu suspenso da 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 suporta 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
<a name="ES-min-time-interval"></a>

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 estar overridden/configured em um painel de controle em 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  |  Segunda  | 
|  ms  |  Milissegundo  | 

### Logs
<a name="ES-logs-beta"></a>

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](explore.md). 

 Por exemplo, se você usar uma configuração padrão do Filebeat para enviar registros para o OpenSearch Serviço, a configuração a seguir deve funcionar. 
+  **Nome do campo da mensagem:** mensagem 
+  **Nome do campo de nível:** fields.level 

### Links de dados
<a name="ES-data-links"></a>

 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.