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

# Carregando dados no Amazon OpenSearch Service com o Logstash
<a name="managedomains-logstash"></a>

A versão de código aberto do Logstash (Logstash OSS) fornece uma maneira conveniente de usar a API em massa para carregar dados em seu domínio do Amazon Service. OpenSearch O serviço oferece suporte a todos os plug-ins de entrada padrão do Logstash, incluindo o plug-in de entrada Amazon S3. OpenSearch O serviço é compatível com o plug-in de saída [logstash-output-opensearch](https://github.com/opensearch-project/logstash-output-opensearch), que oferece suporte à autenticação básica e às credenciais do IAM. O plug-in funciona com a versão 8.1 e inferior do Logstash OSS.

## Configuração
<a name="logstash-config"></a>

A configuração do Logstash varia de acordo com o tipo de autenticação utilizada pelo seu domínio.

Não importa que método de autenticação você use, é necessário definir `ecs_compatibility`como `disabled` na seção de saída do arquivo de configuração. O Logstash 8.0 introduziu uma mudança revolucionária em que todos os plug-ins são executados no [modo de compatibilidade com ECS por padrão](https://www.elastic.co/guide/en/logstash/current/ecs-ls.html#_specific_plugin_instance). Você deve substituir o valor padrão para manter o comportamento herdado.

### Fine-grained configuração de controle de acesso
<a name="logstash-config-fgac"></a>

Se seu domínio OpenSearch de serviço usa [controle de acesso refinado](fgac.md) com autenticação básica HTTP, a configuração é semelhante a qualquer outro cluster. OpenSearch Este arquivo de configuração de exemplo obtém a entrada da versão de código aberto do Filebeat (Filebeat OSS):

```
input {
  beats  {
    port => 5044
  }
}

output {
  opensearch {
    hosts       => "https://{{domain-endpoint}}:443"
    user        => "{{my-username}}"
    password    => "{{my-password}}"
    index       => "logstash-logs-%{+YYYY.MM.dd}"
    ecs_compatibility => disabled
    ssl_certificate_verification => false
  }
}
```

A configuração varia de acordo com a aplicações Beats e o caso de uso, mas sua configuração do Filebeat OSS pode ser semelhante a esta:

```
filebeat.inputs:
- type: log
  enabled: true
  paths:
    - {{/path/to/logs/dir/}}*.log
filebeat.config.modules:
  path: ${path.config}/modules.d/*.yml
  reload.enabled: false
setup.ilm.enabled: false
setup.ilm.check_exists: false
setup.template.settings:
  index.number_of_shards: 1
output.logstash:
  hosts: ["{{logstash-host}}:5044"]
```

### Configuração do IAM
<a name="logstash-config-iam"></a>

Se seu domínio usa uma política de acesso ao IAM-based domínio ou um controle de acesso refinado com um usuário principal, você deve assinar todas as solicitações ao OpenSearch Serviço usando as credenciais do IAM. A política baseada em identidade a seguir concede todas as solicitações HTTP para os sub-recursos do seu domínio.

------
#### [ JSON ]

****  

```
{
  "Version":"2012-10-17",		 	 	 
  "Statement": [
    {
      "Effect": "Allow",
      "Action": [
        "es:ESHttp*"
      ],
      "Resource": "arn:aws:es:{{us-east-1}}:{{111122223333}}:domain/{{domain-name}}/*"
    }
  ]
}
```

------

Para configurar o Logstash, altere o seu arquivo de configuração para usar o plug-in para a saída. Este arquivo de configuração de exemplo obtém a entrada de arquivos em um bucket do S3:

```
input {
  s3 {
    bucket => "{{amzn-s3-demo-}}"
    region => "{{us-east-1}}"
  }
}

output {        
  opensearch {     
    hosts => ["{{domain-endpoint}}:443"]             
    auth_type => {    
      type => 'aws_iam'     
      aws_access_key_id => '{{your-access-key}}'     
      aws_secret_access_key => '{{your-secret-key}}'     
      region => '{{us-east-1}}'         
      }         
      index  => "logstash-logs-%{+YYYY.MM.dd}"  
      ecs_compatibility => disabled    
  }            
}
```

Se você não quiser fornecer as suas credenciais do IAM no arquivo de configuração, poderá exportá-las (ou executar o `aws configure`):

```
export AWS_ACCESS_KEY_ID="{{your-access-key}}"
export AWS_SECRET_ACCESS_KEY="{{your-secret-key}}"
export AWS_SESSION_TOKEN="{{your-session-token}}"
```

Se seu domínio OpenSearch de serviço estiver em uma VPC, a máquina Logstash OSS deverá ser capaz de se conectar à VPC e ter acesso ao domínio por meio dos grupos de segurança da VPC. Para obter mais informações, consulte [Sobre políticas de acesso em domínios da VPC](vpc.md#vpc-security).

Os métodos de autenticação compatíveis com o Logstash incluem: (1) Autenticação básica HTTP com o banco de dados interno de usuários de controle de acesso refinado, (2) credenciais do IAM especificadas diretamente no arquivo de configuração, (3) credenciais do IAM exportadas como variáveis de ambiente e (4) perfis de instância do EC2 ao executar o Logstash em uma instância do EC2. Ao usar um perfil de instância do EC2, o `logstash-output-opensearch` plug-in recupera automaticamente as credenciais temporárias do serviço de metadados da instância, portanto, você não precisa especificar `aws_access_key_id` nem `aws_secret_access_key` inserir na configuração.