Uso do OpenSearch Dashboards com o Amazon OpenSearch Service

O OpenSearch Dashboards é uma ferramenta de código aberto popular para visualização, projetada para funcionar com o OpenSearch. O Amazon OpenSearch Service permite a instalação do Dashboards com todos os domínios do OpenSearch Service. O OpenSearch Dashboards é executado nos nós de dados quentes do domínio.

O OpenSearch Dashboards é uma ferramenta de visualização para explorar e analisar dados em um único domínio do OpenSearch. Por outro lado, a interface de usuário centralizada do OpenSearch (também chamada de aplicação do OpenSearch) é uma interface de usuário baseada em nuvem que se conecta a vários domínios do OpenSearch, coleções do OpenSearch sem Servidor e fontes de dados da AWS. Ela inclui espaços de trabalho para casos de uso específicos, como observabilidade e analytics de segurança, e fornece uma experiência unificada em todos os conjuntos de dados. Embora o Dashboards seja vinculado aos domínios individuais, a interface de usuário centralizada permite integração e análise de dados entre domínios. Para obter mais informações, consulte Usar a OpenSearch UI no Amazon OpenSearch Service.

Você pode encontrar um link para o OpenSearch Dashboards em seu painel de domínio no console do OpenSearch Service. Para domínios que executam o OpenSearch, o URL é domain-endpoint/_dashboards/. Para domínios que executam o Elasticsearch legado, o URL é domain-endpoint/_plugin/kibana.

As consultas que usam essa instalação padrão do Dashboads têm um tempo limite de 300 segundos.

Controlar acesso ao Dashboards

O Dashboards não oferece suporte nativo a usuários e funções do IAM, mas o OpenSearch Service oferece diversas soluções para controlar o acesso ao Dashboards:

Uso de proxy para acessar o OpenSearch Service via Dashboards

Como o Dashboards é uma aplicação JavaScript, as solicitações são originadas no endereço IP do usuário. O controle de acesso baseado em IP pode ser impraticável devido ao grande número de endereços IP que você precisaria inserir em uma lista de permissões para que cada usuário tivesse acesso ao Dashboards. Uma solução alternativa é colocar um servidor proxy entre o OpenSearch Dashboards e o OpenSearch Service. Em seguida, você pode adicionar uma política de acesso com base em IP que permite solicitações de apenas um endereço IP, o do proxy. O diagrama a seguir mostra essa configuração.

Para habilitar esse tipo de configuração, você precisa de uma política com base em recursos que especifica funções e endereços IP. Aqui está um exemplo de política:

JSON

{
   "Version":"2012-10-17",		 	 	 
   "Statement":[
      {
         "Resource":"arn:aws:es:us-west-2:111111111111:domain/my-domain/*",
         "Principal":{
            "AWS":"arn:aws:iam::111111111111:role/allowedrole1"
         },
         "Action":[
            "es:ESHttpGet"
         ],
         "Effect":"Allow"
      },
      {
         "Effect":"Allow",
         "Principal":{
            "AWS":"*"
         },
         "Action":"es:*",
         "Condition":{
            "IpAddress":{
               "aws:SourceIp":[
                  "203.0.113.0/24",
                  "2001:DB8:1234:5678::/64"
               ]
            }
         },
         "Resource":"arn:aws:es:us-west-2:111111111111:domain/my-domain/*"
      }
   ]
}

Recomendamos configurar a instância do EC2 executando o servidor de proxy com um endereço IP elástico. Dessa forma, você pode substituir a instância quando necessário e ainda anexar o mesmo endereço IP público. Para saber mais, consulte Endereços IP elásticos no Guia do usuário do Amazon EC2.

Se você usar um servidor de proxy e a autenticação do Cognito, talvez seja necessário adicionar configurações do Dashboards e do Amazon Cognito para evitar erros de redirect_mismatch. Veja o exemplo nginx.conf a seguir:

server {
    listen 443;
    server_name $host;
    rewrite ^/$ https://$host/_plugin/_dashboards redirect;

    ssl_certificate           /etc/nginx/cert.crt;
    ssl_certificate_key       /etc/nginx/cert.key;

    ssl on;
    ssl_session_cache  builtin:1000  shared:SSL:10m;
    ssl_protocols  TLSv1 TLSv1.1 TLSv1.2;
    ssl_ciphers HIGH:!aNULL:!eNULL:!EXPORT:!CAMELLIA:!DES:!MD5:!PSK:!RC4;
    ssl_prefer_server_ciphers on;

    location /_plugin/_dashboards {
        # Forward requests to Dashboards
        proxy_pass https://$dashboards_host/_plugin/_dashboards;

        # Handle redirects to Cognito
        proxy_redirect https://$cognito_host https://$host;

        # Update cookie domain and path
        proxy_cookie_domain $dashboards_host $host;
        proxy_cookie_path / /_plugin/_dashboards/;

        # Response buffer settings
        proxy_buffer_size 128k;
        proxy_buffers 4 256k;
        proxy_busy_buffers_size 256k;
    }

    location ~ \/(log|sign|fav|forgot|change|saml|oauth2) {
        # Forward requests to Cognito
        proxy_pass https://$cognito_host;

        # Handle redirects to Dashboards
        proxy_redirect https://$dashboards_host https://$host;

        # Update cookie domain
        proxy_cookie_domain $cognito_host $host;
    }
}

Configurar o OpenSearch Dashboards para usar um servidor de mapas WMS

A instalação padrão do OpenSearch Dashboards para OpenSearch Service inclui um serviço de mapas, exceto para domínios nas regiões da Índia e da China. O serviço de mapa oferece suporte a até 10 níveis de zoom.

Independentemente da sua região, é possível configurar o Dashboards para usar um servidor diferente do Web Map Service (WMS) para coordenar visualizações de mapas. As visualizações de mapa de região oferecem suporte apenas ao serviço de mapa padrão.

Para aplicar o novo valor padrão a visualizações, talvez seja necessário recarregar o Dashboards. Se você salvou as visualizações, selecione Opções depois de abrir a visualização. Verifique se o Servidor de mapas WMS está habilitado e se o URL do WMS contém o servidor de mapas de sua preferência e selecione Aplicar alterações.

Conexão de um servidor local do Dashboards ao OpenSearch Service

Se já investiu um tempo significativo na configuração da instância do OpenSearch Dashboards, poderá usaá-la em vez (ou além) da instância padrão do Dashboards fornecida pelo OpenSearch Service. O procedimento a seguir destina-se a domínios que usam o controle de acesso refinado com uma política de acesso aberto.

Para ver os índices do OpenSearch Service, inicie o servidor local do Dashboards, acesse Dev Tools (Ferramentas de desenvolvimento) e execute o seguinte comando:

GET _cat/indices

Gerenciar índices no Dashboards

A instalação do Dashboards no domínio do OpenSearch Service fornece uma interface de usuário útil para gerenciar índices em diferentes níveis de armazenamento no domínio. Escolha Index management (Gerenciamento de índices) no menu principal do Dashboards para visualizar todos os índices no armazenamento quente, UltraWarm e frio, bem como índices gerenciados pelas políticas de gerenciamento de estados dos índices (ISM). Use o gerenciamento de índices para mover índices entre os armazenamentos mornos e frios, e para monitorar migrações entre os três níveis.

Observe que você não verá as opções de índice quente, morno e frio, a menos que tenha o armazenamento UltraWarm e/ou frio habilitado.

Recursos adicionais

A instalação padrão do Dashboards em cada domínio do OpenSearch Service tem alguns recursos adicionais: