Configurando seu delivery stream

A tela Data Streaming exibe todos os Delivery Streams por meio de cards contendo informações básicas a respeito de cada um deles:

  • Nome do delivery stream;

  • Se está ativo ou inativo;

  • Destination: destino do delivery stream (Datadog, AWS S3 ou Dynatrace);

  • Creation Date: data da criação do delivery stream.

  • Ao ativar a exportação dos traces, pode ocorrer um aumento na cobrança desses serviços, que não está relacionada à Sensedia.

  • A ativação ou desativação do Data Streaming pode demorar até 15 minutos.

Configurando novo delivery stream

Veja como configurar um novo delivery stream tendo como destino:

  • Para AWS3 (JSON): os traces serão exportados como um objeto compactado gzip.

  • Cada objeto exportado pode conter vários traces.

As chaves de acesso do Data Streaming são criptografadas e por isso não são visíveis na tela e não é possível recuperá-las após salvas.

Caso não consiga criar, editar ou deletar um Data Stream, verifique suas permissões de acesso.

Datadog

Para criar um novo delivery stream tendo como destino o Datadog, siga os passos abaixo:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Clique no botão + NEW DELIVERY STREAM.
    detalhe da tela com o botão new delivery stream

  3. Complete os campos:

    detalhe da tela de criação de novo delivery stream datadog

    • Destination: selecione Datadog;

    • Delivery stream name: defina um nome para o delivery stream. Não utilize espaços nem caracteres especiais;

    • Site: selecione o site do Datadog para onde suas métricas e traces serão enviados;

    • API key: informe a API key. Ela pode ser encontrada no Datadog em Organization Settings  API Keys.

  4. Clique em ACTIVATE para confirmar a ativação do Delivery stream.
    tela de confirmação de ativação do delivery stream

Para exportar traces para o Datadog, você precisará da licença APM Host. Para mais informações, consulte o modelo de cobrança do Datadog.



AWS S3 (Open Telemetry)

Para criar um novo delivery stream tendo como destino AWS S3, siga os passos abaixo:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Clique no botão + NEW DELIVERY STREAM.
    detalhe da tela com o botão new delivery stream

  3. Complete os campos:

    detalhe da tela de criação de streaming para aws

    • Destination: selecione AWS S3;

    • Delivery stream name: defina um nome para o delivery stream. Não utilize espaços nem caracteres especiais;

    • AWS Region: selecione a região onde seu AWS S3 está hospedado.

    • Bucket name: informe um bucket da AWS S3 para o qual os data streamings serão enviados. Você precisa ser proprietário desse bucket para permitir que ele seja utilizado como destino.

    • Key: informe a chave (access key ID) do seu recurso;

      A chave de acesso que você informar precisa ter as permissões especificadas no bucket AWS S3 — PutObject, GetObject e AbortMultipartUpload — ao criar o Data Streaming.

    • Secret: informe o segredo (secret access key) associado à chave.

  4. Clique em ACTIVATE para confirmar a ativação do Delivery stream.
    tela de confirmação de ativação do delivery stream


Dynatrace

Para criar um novo delivery stream tendo como destino o Dynatrace, siga os passos abaixo:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Clique no botão + NEW DELIVERY STREAM.
    detalhe da tela com o botão new delivery stream

  3. Complete os campos:

    campos para preenchimento dynatrace

    • Destination: selecione Dynatrace;

    • Delivery stream name: defina um nome para o delivery stream. Não utilize espaços nem caracteres especiais;

    • Active Gate URL: Forneça a URL da sua instância do Dynatrace ActiveGate. Certifique-se de que a URL esteja acessível e configurada corretamente para receber os dados exportados.

    • API access token: Insira um token de acesso à API válido para o Dynatrace. O token deve ter as permissões necessárias para autenticar e enviar dados para o destino especificado.

      Certifique-se de que o token possui permissões para a ingestão de OpenTelemetry traces, metrics e logs.

  4. Clique em ACTIVATE para confirmar a ativação do Delivery stream.
    tela de confirmação de ativação do delivery stream

Ao exportar dados para o Dynatrace, apenas um destino pode ser configurado.


Datadog Agent (OTLP)

Para criar um novo delivery stream com destino ao Datadog Agent (OTLP), siga os passos abaixo:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Clique no botão + NEW DELIVERY STREAM.
    detalhe da tela com o botão new delivery stream

  3. Complete os campos:

    detalhe da tela de criação de streaming para aws

    • Destination: selecione OTLP (Datadog Agent);

    • Delivery stream name: defina um nome para o delivery stream. Não utilize espaços nem caracteres especiais;

    • Endpoint: informe o endpoint gRPC do seu Datadog Agent. O endpoint deve ser acessível e configurado corretamente para receber os dados exportados.

      A conexão é realizada via protocolo gRPC. Certifique-se de usar um endpoint compatível com esse protocolo.

  4. Clique em CREATE para confirmar a ativação do Delivery stream.
    tela de confirmação de ativação do delivery stream


AWS S3 (JSON)

A configuração do envio de dados para a AWS S3 em JSON é realizada pelo suporte.
Siga os passos abaixo para abrir um chamado:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Clique no botão + NEW DELIVERY STREAM.
    detalhe da tela com o botão new delivery stream

  3. Selecione AWS S3 (JSON) em Destination.

  4. De posse das informações listadas abaixo, clique no botão CREATE TICKET.
    Você será redirecionado para a tela de abertura de chamado do Zendesk.

    • Delivery stream name: defina um nome para o delivery stream, sem espaços nem caracteres especiais;

    • AWS region: a região onde o bucket está hospedado;

    • Bucket name: nome do bucket da AWS S3 para o qual os data streamings serão enviados. Você precisa ser proprietário desse bucket para permitir que ele seja utilizado como destino;

    • Root path (opcional): caminho raiz do bucket onde os dados serão armazenados.

    • Key/secret ou role ARN:

      • Se você informar uma chave (access key ID), informe também o segredo (secret access key) associado a ela.

      • Se você informar um role ARN, não é necessário informar a chave e o segredo.
        Nesse caso, informe um External ID.

        • Tanto o access key ID como a role ARN (e o External ID, quando aplicável) que você informar precisam ter as permissões especificadas no bucket AWS S3 —PutObject, GetObject, AbortMultipartUpload— ao criar o Data Streaming.

        • O External ID é obrigatório quando a integração utiliza uma Role ARN para acessar o bucket AWS S3. Ele adiciona uma camada extra de segurança, impedindo que entidades não autorizadas assumam a role.

    • Partição (partition): a partição do AWS S3 onde os dados serão armazenados, podendo ser por year, month, day e hour.

A informação sobre Data Transfer foi removida do Data Streaming.


Azure

A configuração do envio de dados para a Azure é realizada pelo suporte.
Siga os passos abaixo para abrir um chamado:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Clique no botão + NEW DELIVERY STREAM.
    detalhe da tela com o botão new delivery stream

  3. Selecione Azure em Destination.

  4. De posse das informações listadas abaixo, clique no botão CREATE TICKET.
    Você será redirecionado para a tela de abertura de chamado do Zendesk.

    • Delivery stream name: defina um nome para o delivery stream, sem espaços nem caracteres especiais;

    • Azure container name: nome do container da Azure onde os dados serão armazenados;

    • Account name: nome da conta da Azure onde o container está localizado;

    • Credentials: forneça uma das seguintes opções de credenciais:

      • Account Key: chave de acesso da conta da Azure;

      • SAS token: token de assinatura de acesso compartilhado;

      • Connection string: string de conexão com a conta da Azure.

Google Cloud

A configuração do envio de dados para o Google Cloud é realizada pelo suporte.
Siga os passos abaixo para abrir um chamado:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Clique no botão + NEW DELIVERY STREAM.
    detalhe da tela com o botão new delivery stream

  3. Selecione Google Cloud em Destination.

  4. De posse das informações listadas abaixo, clique no botão CREATE TICKET.
    Você será redirecionado para a tela de abertura de chamado do Zendesk.

    • Delivery stream name: defina um nome para o delivery stream, sem espaços nem caracteres especiais;

    • Google Cloud Storage bucket name: nome do bucket do Google Cloud onde os dados serão armazenados;

    • Credentials (service account key from GCP): forneça a chave da conta de serviço do GCP.

Editando as configurações do delivery stream

Para trocar o site do Datadog ou a API Key — para destinos Datadog; ou para trocar o bucket, AWS Region, chave (access key) ou segredo (secret access key) — para destinos AWS S3, siga os passos abaixo:

  1. Acesse a tela Data Streaming pelo menu esquerdo ou pelo card que fica na tela inicial do seu Analytics.

  2. Encontre o Delivery Stream que deseja editar. Você pode pesquisar pelo nome ou parte dele.

  3. Clique em ícone de um lápis representando a ação de edição.

  4. Altere as informações e clique em SAVE.

Após alteradas, as configurações originais não poderão ser recuperadas.

Deletando um delivery stream

Para deletar um delivery stream, clique em ícone de uma lixeira representando a ação de deleção.

  • O delivery stream deletado não poderá ser recuperado. A exclusão pode levar alguns minutos para ser efetivada.

  • Alguns delivery streams são deletados apenas pelo suporte. Caso o botão para deletar esteja desativado, abra um chamado.
Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]