# Como configurar sampling no Data Stream

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


Ao [configurar um stream](/pt-br/documentacao/produtos/guias/como-usar-data-stream/) e escolher associar todos os seus domínios, você pode configurar a opção de **Sampling** para filtrar a porcentagem de dados que será transmitida. Essa é uma opção viável para reduzir os custos da coleta e análise de dados.

:::caution[aviso]
Para habilitar Sampling em sua conta, você deve entrar em contato com a [equipe de vendas](https://www.azion.com/pt-br/contato/) e solicitar a funcionalidade.

Após ativar a função de Sampling, você só poderá ter um stream ativo. Se você desativar a funcionalidade, poderá criar mais streams novamente.
:::

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

<Fragment slot="panel.console">

1. [Acesse o Azion Console](/pt-br/documentacao/produtos/guias/como-acessar-o-azion-console/) > **Data Stream**.
2. Para configurar o stream, siga as etapas em [Como configurar as main settings do Data Stream](/pt-br/documentacao/produtos/guias/como-usar-data-stream/).
3. Em **Workloads** > **Options**, escolha **All Current and Future Domains**. Isso associará todos os domínios atuais e futuros da conta a este stream.
4. Em **Sampling (%)**, adicione o valor da porcentagem de dados que deseja transmitir, de `0` a `100`. Exemplo: `60`.
    - O Data Stream coletará dados aleatoriamente de acordo com a porcentagem escolhida.
5. Finalize a configuração da seção **Destination**.
6. Clique no botão **Save**.

</Fragment>

<Fragment slot="panel.api">

Para esta seção, você estará criando um stream com um conector Apache Kafka via API. Veja outras opções de conectores na tabela [Data Stream Endpoints](https://api.azion.com/#04257075-3691-4b5f-b22b-22a5b6653f3f).

1. Execute a seguinte requisição `POST` em seu terminal, substituindo `[VALOR DO TOKEN]` pelo seu [token pessoal](/pt-br/documentacao/produtos/guias/personal-tokens/):

```bash
curl --request POST \
  --url https://api.azion.com/v4/data_stream/streams \
  --header 'Accept: application/json' \
  --header 'Authorization: [TOKEN VALUE]' \
  --header 'Content-Type: application/json' \
--data '{
    "name": "Kafka Connector",
    "template_id": 2,
    "workloads": [1656613172],
    "data_source": "http",
    "endpoint": {
        "endpoint_type": "kafka",
        "kafka_topic": "mykafka.dts.topic",
        "bootstrap_servers": "infra.my.net:9094,infra.my.net:9094"
    },
    "all_domains": true,
    "sampling_percentage": 60
}'
```

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

```json
{
  "results": {
    "id": 1594,
    "name": "Kafka Connector",
    "template_id": 2,
    "data_source": "http",
    "active": true,
    "endpoint": {
      "endpoint_type": "kafka",
      "use_tls": false,
      "kafka_topic": "mykafka.dts.topic",
      "bootstrap_servers": "infra.my.net:9094,infra.my.net:9094"
    },
    "all_domains": true,
    "sampling_percentage": 60
  },
  "schema_version": 3
}
```

Aguarde alguns minutos para que as alterações se propaguem e seu stream será atualizado.

<JourneyAPI />

</Fragment>
</Tabs>
<br /><br />