# Como configurar as main settings do Data Stream

import Tabs from '~/components/tabs/Tabs'
import JourneyAPI from '~/includes/snippets/JourneyAPI/pt/snippet.mdx'


Ao acessar o Data Stream por meio do [Azion Console](https://console.azion.com/data-stream) ou da [Azion API](https://api.azion.com/#04257075-3691-4b5f-b22b-22a5b6653f3f), você pode realizar diversas ações para gerenciar seus fluxos de dados, incluindo [criar um novo data stream](/pt-br/documentacao/produtos/guias/como-usar-data-stream/), conectar seus data streams a [endpoints](/pt-br/documentacao/produtos/guias/#observe), [editar as configurações](/pt-br/documentacao/produtos/guias/como-usar-data-stream/), [visualizar informações detalhadas](/pt-br/documentacao/produtos/observe/troubleshoot/data-stream-monitorar-metricas/) sobre cada stream e [excluir ou parar data streams](/pt-br/documentacao/produtos/guias/observe/deletar-data-stream/) que não são mais necessários.

Para obter informações mais detalhadas sobre o produto e cada configuração, consulte a [documentação de referência](/pt-br/documentacao/produtos/observe/data-stream/).

:::note
Todos os campos `key` serão mascarados e um ícone que permite revelar o conteúdo do campo será exibido apenas para usuários com a permissão `Edit Data Stream`. Usuários sem a permissão `Edit Data Stream` podem apenas visualizar as configurações do stream existente, mas não podem editar ou criar novos.
:::

<Tabs client:visible>
    <Fragment slot="tab.console">Console</Fragment>
    <Fragment slot="tab.api">API</Fragment>

<Fragment slot="panel.console">

Nesta seção, você modificará as configurações principais de sua transmissão: nome, fonte de dados, modelo, domínios e destino via [Azion Console](https://console.azion.com).

1. [Acesse o Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Data Stream**.
2. Na lista, selecione o stream que deseja editar ou clique no botão **+ Stream**.
3. Dê ao stream um nome único e fácil de lembrar.
4. No menu suspenso **Source**, selecione o que deseja usar: **Activity History**, **Applications**, **Functions** ou **WAF Events**.
    - Para usar Functions e WAF Events, você deve [ter os produtos ativados](/pt-br/documentacao/produtos/observe/data-stream/#selecionar-data-source).
5. No campo **Template**, selecione o que desejar usar.
    - Caso escolha usar um template personalizado, na caixa de código **Data Set**, adicione as variáveis que você deseja usar nas análises de seus logs. Veja mais sobre [Criar um template personalizado no Data Stream](/pt-br/documentacao/produtos/guias/data-stream-template-personalizado/).
6. Em **Workloads** > **Options**, selecione **All Current and Future Domains** ou **Filter Domains**.
    - Saiba mais sobre cada opção em [Como associar domínios no Data Stream](/pt-br/documentacao/produtos/guias/data-stream-associar-dominios/).
7. Na seção **Destination**, selecione um **Connector** na lista suspensa: **Standard HTTP/HTTPS POST**, **Apache Kafka**, **Simples Storage Service (S3)**, **Google BigQuery**, **Elasticsearch**, **Splunk**, **AWS Kinesis Data Firehose**, **Datadog**, **IBM QRadar**, **Azure Monitor** ou **Azure Blob Storage**.
    - Os campos para preenchimento são diferentes dependendo do tipo de endpoint que você escolher. Descubra mais informações sobre cada campo na página de [configuração de endpoint](/pt-br/documentacao/produtos/observe/data-stream/#endpoints).
8. Clique no botão **Save**.

</Fragment>

<Fragment slot="panel.api">

Nesta seção, você estará modificando um stream existente com um conector Elasticsearch via API. Para criar um novo, use o [método POST do Data Stream](https://api.azion.com/#ed05fed1-9e69-4f6f-b086-81095b8cd738).

Consulte a tabela de [Data Stream Properties](https://api.azion.com/#ed05fed1-9e69-4f6f-b086-81095b8cd738) para ver todas as propriedades disponíveis e seus valores aceitos.

1. Execute a seguinte requisição `GET` em seu terminal, substituindo `[TOKEN VALUE]` pelo seu [personal token](/pt-br/documentacao/produtos/guias/personal-tokens/) para recuperar seu `<data_streaming_id>`:

```bash
curl --request GET \
  --url https://api.azion.com/v4/data_stream/streams \
  --header 'Accept: application/json' \
  --header 'Authorization: [TOKEN VALUE]'
```

2. Você receberá uma resposta com todos os seus streams existentes. Copie o valor do `<id>` que deseja configurar.
3. Execute uma requisição `PATCH` para modificar o stream da seguinte forma:

```bash
curl --request PATCH \
  --url https://api.azion.com/v4/data_stream/streams/id \
  --header 'Accept: application/json' \
  --header 'Authorization: [TOKEN VALUE]' \
  --header 'Content-Type: application/json' \
--data '{
	"name": "My Elasticsearch connector",
    "template_id": 2,
    "domain_ids": [1656613172],
    "data_source": "http",
    "endpoint": {
        "endpoint_type": "elasticsearch",
        "url": "http://elasticsearch-domain.com",
        "api_key": "VuaCfGcBCdbkQm-e5aOx:ui2lp2axTNmsyakw9tvNnw"
    },
    "all_domains": false
}'
```

| Chave | Descrição |
| --- | --- |
| `name` | Nome do stream |
| `template_id` | Identificador do template sendo usado |
| `domain_ids` | Valor de array dos identificadores (integers) dos domínios que você deseja associar ao stream |
| `data_source` | Data source do qual você deseja transmitir seus dados |
| `endpoint` | Endpoint para o qual você deseja transmitir seus dados |
| `all_domains` | Usado para associar todos os domínios atuais e futuros em sua conta ao stream |

4. Você receberá uma resposta semelhante a esta:

```json
{
  "results": {
    "id": 1560,
    "name": "My Elasticsearch connector",
    "template_id": 2,
    "data_source": "http",
    "active": true,
    "endpoint": {
      "endpoint_type": "elasticsearch",
      "url": "http://elasticsearch-domain.com",
      "api_key": "VuaCfGcBCdbkQm-e5aOx:ui2lp2axTNmsyakw9tvNnw"
    },
    "all_domains": false
  },
  "schema_version": 3
}
```

Aguarde alguns minutos para que as alterações se propaguem e sua transmissão será atualizada.

<JourneyAPI />

</Fragment>
</Tabs>

<br /><br />
---