

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

# aws-lambda-elasticsearch-kibana
<a name="aws-lambda-elasticsearch-kibana"></a>

![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/experimental.png)


 Todas as classes estão em desenvolvimento ativo e estão sujeitas a alterações ou remoção não compatíveis com versões anteriores em qualquer versão futura. Estes não estão sujeitos à[Versionamento semântico](https://semver.org/)Modelo. Isso significa que, embora você possa usá-los, você pode precisar atualizar seu código-fonte ao atualizar para uma versão mais recente deste pacote. 

**Observações:** Para garantir a funcionalidade adequada, os pacotes AWS Solutions Constructs e os pacotes CDK da AWS em seu projeto devem ser da mesma versão. 


|  **Linguagem**  |  **Pacote**  | 
| --- | --- | 
|  ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/python.png) Python  |  aws\_solutions\_constructs.aws\_lambda\_elasticsearch\_kibana  | 
|  ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/typescript.png) TypeScript  |  @aws-solutions-constructs/aws-lambda-elasticsearch-kibana  | 
|  ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/java.png) Java  |  software.amazon.awsconstructs.services.lambdaelasticsearchkibana  | 

## Overview
<a name="overview-18"></a>

 Este AWS Solutions Construct implementa uma função do AWS Lambda e um domínio do Amazon Elasticsearch Service com permissões menos privilegiadas.

 Aqui está uma definição de padrão implantável mínima no TypeScript: 

```
import { LambdaToElasticSearchAndKibana } from '@aws-solutions-constructs/aws-lambda-elasticsearch-kibana';
import { Aws } from "@aws-cdk/core";

const lambdaProps: lambda.FunctionProps = {
    runtime: lambda.Runtime.NODEJS_14_X,
    // This assumes a handler function in lib/lambda/index.js
    code: lambda.Code.fromAsset(`${__dirname}/lambda`),
    handler: 'index.handler'
};

new LambdaToElasticSearchAndKibana(this, 'test-lambda-elasticsearch-kibana', {
    lambdaFunctionProps: lambdaProps,
    domainName: 'test-domain',
    // TODO: Ensure the Cognito domain name is globally unique
    cognitoDomainName: 'globallyuniquedomain' + Aws.ACCOUNT_ID;
});
```

## Initializer
<a name="initializer-18"></a>

```
new LambdaToElasticSearchAndKibana(scope: Construct, id: string, props: LambdaToElasticSearchAndKibanaProps);
```

 *Parâmetros* 
+  escopo[https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_core.Construct.html) 
+  id`string` 
+  props[`LambdaToElasticSearchAndKibanaProps`](#pattern-construct-props-18) 

## Estrutura de construção de padrão
<a name="pattern-construct-props-18"></a>


|  **Nome**  |  **Tipo**  |  **Descrição**  | 
| --- | --- | --- | 
|  ExistingAmbdaobj?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  Instância existente do objeto Lambda Function, fornecendo tanto isso elambdaFunctionPropscausará um erro.  | 
|  LambdaFunctionProps?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.FunctionProps.html)  |  Propriedades opcionais fornecidas pelo usuário para substituir as propriedades padrão da função Lambda. Ignorado se umexistingLambdaObjé fornecido.  | 
|  EsdomainProps?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-elasticsearch.CfnDomainProps.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-elasticsearch.CfnDomainProps.html)  |  O usuário opcional forneceu adereços para substituir os adereços padrão do Amazon Elasticsearch Service  | 
|  domainName  |  string  |  Nome de domínio para o Cognito e o Amazon Elasticsearch Service  | 
|  CognitoDomainName?  |  string  |  Nome de domínio do Cognito opcional. Se fornecido, ele será usado para o domínio do Cognito, edomainNameserá usado para o domínio Elasticsearch.  | 
|  CreateCloudWatchAlms  |  boolean  |  Criar alarmes recomendados do CloudWatch.  | 
|  DomainEndPointEnvironmentVariableName?  |  string  |  Nome opcional para o conjunto de variáveis de ambiente de endpoint de domínio ElasticSearch para a função Lambda.  | 

## Propriedades do padrão
<a name="pattern-properties-18"></a>


|  **Nome**  |  **Tipo**  |  **Descrição**  | 
| --- | --- | --- | 
|  CloudwatchAlarm?  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cloudwatch.Alarm.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cloudwatch.Alarm.html)  |  Retorna uma lista de um ou mais alarmes do CloudWatch criados pelo padrão.  | 
|  ElasticSearchDomain  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-elasticsearch.CfnDomain.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-elasticsearch.CfnDomain.html)  |  Retorna uma instância do domínio Elasticsearch criado pelo padrão.  | 
|  ElasticSearchDomainRole  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-iam.Role.html)  |  Retorna uma instância da função do IAM criada pelo padrão para o domínio do Elasticsearch.  | 
|  IdentityPool  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cognito.CfnIdentityPool.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cognito.CfnIdentityPool.html)  |  Retorna uma instância do pool de identidades do Cognito criado pelo padrão.  | 
|  LambdaFunction  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-lambda.Function.html)  |  Retorna uma instância da função Lambda criada pelo padrão.  | 
|  userPool  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cognito.UserPool.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cognito.UserPool.html)  |  Retorna uma instância do grupo de usuários do Cognito criado pelo padrão.  | 
|  UserPoolCli  |  [https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cognito.UserPoolClient.html](https://docs.aws.amazon.com/cdk/api/latest/docs/@aws-cdk_aws-cognito.UserPoolClient.html)  |  Retorna uma instância do cliente do grupo de usuários do Cognito criado pelo padrão.  | 

## Função Lambda
<a name="lambda-function-18"></a>

Esse padrão requer uma função do Lambda que possa postar dados no serviço Elasticsearch a partir do stream do DynamoDB. Uma função de exemplo é fornecida[Aqui](https://github.com/awslabs/aws-solutions-constructs/blob/master/source/patterns/%40aws-solutions-constructs/aws-lambda-elasticsearch-kibana/test/lambda/index.js).

## Configurações padrão
<a name="default-settings-18"></a>

 A implementação imediata desse padrão sem substituições definirá os seguintes padrões:

### Função do AWS Lambda
<a name="aws-lambda-function-10"></a>
+  Configurar a função do IAM de acesso de privilégio limitado para a função Lambda 
+  Habilite a reutilização de conexões com a função Keep-Alive para NodeJS Lambda. 
+  Habilitar rastreamento do X-Ray.
+  Definir variáveis de ambiente:
  +  `DOMAIN_ENDPOINT` (padrão)
  +  `AWS_NODEJS_CONNECTION_REUSE_ENABLED`(para funções Node 10.x e superiores)

### Amazon Cognito
<a name="amazon-cognito-2"></a>
+  Defina a política de senha para grupos de usuários. 
+  Imponha o modo de segurança avançado para grupos de usuários. 

### Amazon Elasticsearch Service
<a name="amazon-elasticsearch-service-1"></a>
+  Implante as melhores práticas Alarmes do CloudWatch para o domínio do Elasticsearch. 
+  Proteja o acesso ao painel Kibana com grupos de usuários do Cognito. 
+  Ative a criptografia do lado do servidor para o domínio do Elasticsearch usando a chave KMS gerenciada pela AWS. 
+  Habilite a criptografia de nó a nó para o domínio do Elasticsearch. 
+  Configurar o cluster para o domínio do Amazon ES. 

## Architecture
<a name="architecture-18"></a>

![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/aws-lambda-elasticsearch-kibana.png)


## GitHub
<a name="github-18"></a>


<table>
<thead>
  <tr><th colspan="2"> Para exibir o código desse padrão, crie/exiba problemas e solicitações pull e muito mais: </th></tr>
</thead>
<tbody>
  <tr><td> ![](http://docs.aws.amazon.com/pt_br/solutions/latest/constructs/images/GitHub-Mark-32px.png) </td><td> [@aws -solutions-constructs/aws-lambda-elasticsearch-kibana](https://github.com/awslabs/aws-solutions-constructs/tree/master/source/patterns/%40aws-solutions-constructs/aws-lambda-elasticsearch-kibana) </td></tr>
</tbody>
</table>
