Parceiros de destino de API no Amazon EventBridge - Amazon EventBridge
Observabilidade da Cisco CloudConfluentCoralogixDatadogDynatraceFreshworksMongoDBMomentoNew RelicOperataSalesforceSlackShopifySplunkSumo LogicTriggerMeshZendesk

Parceiros de destino de API no Amazon EventBridge

Use as informações fornecidas pelos seguintes parceiros da AWSpara configurar um destino de API e uma conexão para seu serviço ou aplicação:

Observabilidade da Cisco Cloud

URL do endpoint de invocação de destino da API:

https://tenantName.observe.appdynamics.com/rest/awsevents/aws-eventbridge-integration/endpoint

Tipos de autorização compatíveis:

Credenciais de cliente OAuth

Tokens OAuth são atualizados quando uma resposta 401 ou 407 é exibida

Parâmetros adicionais de autorização necessários:

ID do cliente e segredo do cliente Cisco AppDynamics

Endpoint OAuth:

https://tenantName.observe.appdynamics.com/auth/tenantId/default/oauth2/token

Os seguintes parâmetros do par de chave-valor do OAuth:

Tipo Chave Valor

Campo de corpo

grant_type

client_credentials

Cabeçalho

Content-Type

application/x-www-form-urlencoded; charset=utf-8
Documentação do Cisco AppDynamics:

AWS Ingestão de eventos da

Operações de API comumente usadas:

Não aplicável

Informações adicionais:

Ao selecionar Cisco AppDynamics no menu suspenso Destinos de parceiros, as informações do OAuth necessárias são preenchidas previamente, bem como os pares de chave-valor do cabeçalho e do corpo exigidos para chamadas de API.

Para obter informações adicionais, consulte AWS Events Ingestion na documentação do Cisco AppDynamics.

Confluent

URL do endpoint de invocação de destino da API:

Normalmente, o seguinte formato:

https://random-id.region.aws.confluent.cloud:443/kafka/v3/clusters/cluster-id/topics/topic-name/records

Para obter mais informações, consulte Find the REST endpoint address and cluster ID na documentação da Confluent.

Tipos de autorização compatíveis:

Básico

Parâmetros adicionais de autorização necessários:

Não aplicável

Documentação da Confluent:

Registros do produtor

Confluent REST Proxy para Apache Kafka

Operações de API comumente usadas:

POST

Informações adicionais:

Para transformar os dados de evento em uma mensagem que o endpoint possa processar, crie um transformador de entrada de destino.

  • Para gerar um registro sem especificar uma chave de particionamento do Kafka, use o modelo a seguir para seu transformador de entrada. Nenhum caminho de entrada é necessário. 

    {
  "value":{
      "type":"JSON",
      "data":aws.events.event.json
  },
}

  • Para gerar um registro usando um campo de dados de evento como chave de particionamento do Kafka, siga o caminho de entrada e o exemplo do modelo abaixo. Este exemplo define o caminho de entrada para o campo orderId e especifica esse campo como a chave de particionamento.

    Primeiro, defina o caminho de entrada para o campo de dados de evento:

    {
  "orderId":"$.detail.orderId"
}

    Em seguida, use o modelo do transformador de entrada para especificar o campo de dados como a chave de particionamento:

    {
  "value":{
    "type":"JSON",
    "data":aws.events.event.json
  },
  "key":{
    "data":"<orderId>",
    "type":"STRING"
  }
}

Coralogix

URL do endpoint de invocação de destino da API

Para obter uma lista completa de endpoints, consulte Referência da API do Coralogix.

Tipos de autorização compatíveis

Chave de API

Parâmetros adicionais de autorização necessários

Cabeçalho "x-amz-event-bridge-access-key", o valor é a chave da API Coralogix

Coralogix Documentação do

Autenticação do Amazon EventBridge

Operações de API comumente usadas

EUA: https://ingress.coralogix.us/aws/event-bridge

Cingapura: https://ingress.coralogixsg.com/aws/event-bridge

Irlanda: https://ingress.coralogix.com/aws/event-bridge

Estocolmo: https://ingress.eu2.coralogix.com/aws/event-bridge

Índia: https://ingress.coralogix.in/aws/event-bridge

Mais informações

Os eventos são armazenados como entradas de log com applicationName=[AWS Account] e subsystemName=[event.source].

Datadog

URL do endpoint de invocação de destino da API

Para obter uma lista completa de endpoints, consulte Referência da API do Datadog.

Tipos de autorização compatíveis

Chave de API

Parâmetros adicionais de autorização necessários

Nenhum

Datadog Documentação do

Autenticação

Operações de API comumente usadas

POST https://api.datadoghq.com/api/v1/events

POST https://http-intake.logs.datadoghq.com/v1/input

Mais informações

Os URLs de endpoint diferem dependendo da localização da sua organização do Datadog. Para obter o URL correto para sua organização, consulte a documentação

Dynatrace

URL do endpoint de invocação de destino da API:

  • Logs: https://environment-id.live.dynatrace.com/api/v2/logs/ingest

  • Eventos do Davis: https://environment-id.live.dynatrace.com/platform/ingest/v1/events

  • Eventos do SDLC: https://environment-id.live.dynatrace.com/platform/ingest/v1/events.sdlc

  • Eventos de segurança: https://environment-id.live.dynatrace.com/platform/ingest/v1/events.security

Tipos de autorização compatíveis:

Chave de API

Parâmetros adicionais de autorização necessários:
Tipo Chave Valor

Cabeçalho

Autorização

Api-Token DYNATRACE_API_KEY
Documentação do Dynatrace:
Operações de API comumente usadas:

POST

Informações adicionais:

Cada tipo de endpoint tem o escopo de token, que é necessário para uma autenticação bem-sucedida. Para obter mais informações, consulte APIs de ingestão na documentação do Dynatrace.

Freshworks

URL do endpoint de invocação de destino da API

Para obter uma lista de endpoints, consulte https://developers.freshworks.com/documentation/

Tipos de autorização compatíveis

Básico, chave de API

Parâmetros adicionais de autorização necessários

Não aplicável

Freshworks Documentação do

Autenticação

Operações de API comumente usadas

https://developers.freshdesk.com/api/#create_ticket

https://developers.freshdesk.com/api/#update_ticket

https://developer.freshsales.io/api/#create_lead

https://developer.freshsales.io/api/#update_lead

Mais informações

Nenhum

MongoDB

URL do endpoint de invocação de destino da API

https://data.mongodb-api.com/app/App ID/endpoint/

Tipos de autorização compatíveis

Chave de API

E-mail/senha

Autenticação JWT personalizada

Parâmetros adicionais de autorização necessários

Nenhum

MongoDB Documentação do

API de dados do Atlas

Endpoints

Endpoints HTTPS personalizados

Autenticação

Operações de API comumente usadas

Nenhum

Mais informações

Nenhum

Momento

URL do endpoint de invocação de destino da API:

https://api.cache.region.prod.a.momentohq.com/cache/cacheName

https://api.cache.region.prod.a.momentohq.com/topics/cacheName/topicName

Tipos de autorização compatíveis:

Chave de API

Parâmetros adicionais de autorização necessários:
Tipo Chave Valor

Cabeçalho

Autorização

MOMENTO_API_KEY
Documentação do Momento:

Momento + Amazon EventBridge

Usar a API de tópicos do Momento

Referência da API para cache do Momento

Operações de API comumente usadas:

Para caches: PUT, DELETE

Para tópicos: POST

Informações adicionais:

Ao atualizar ou excluir um cache, inclua os seguintes parâmetros de string de consulta na configuração do destino da regra:

  • A chave que você deseja atualizar no cache do Momento

  • A vida útil (TTL) do item de cache

Por exemplo, se seu evento de entrada incluiu um campo details com esses valores:

key: $.details.key ttl_seconds: $.details.ttl_seconds

New Relic

URL do endpoint de invocação de destino da API

Para obter mais informações, consulte Nossos datacenters nas regiões da UE e dos EUA.

Events (Eventos

EUA: https://insights-collector.newrelic.com/v1/accounts/YOUR_NEW_RELIC_ACCOUNT_ID/events

UE: https://insights-collector.eu01.nr-data.net/v1/accounts/YOUR_NEW_RELIC_ACCOUNT_ID/events

Métricas

EUA: https://metric-api.newrelic.com/metric/v1

UE: https://metric-api.eu.newrelic.com/metric/v1

Logs

EUA: https://log-api.newrelic.com/log/v1

UE: https://log-api.eu.newrelic.com/log/v1

Rastreamentos

EUA: https://trace-api.newrelic.com/trace/v1

UE: https://trace-api.eu.newrelic.com/trace/v1

Tipos de autorização compatíveis

Chave de API

New Relic Documentação do

Métrica de API

API de eventos

Registrar API

API de rastreamento

Operações de API comumente usadas

Métrica de API

API de eventos

Registrar API

API de rastreamento

Mais informações

Limites métricos de API

Limites da API de eventos

Limites de registro da API

Limites de rastreamento de API

Operata

URL do endpoint de invocação de destino da API:

https://api.operata.io/v2/aws/events/contact-record

Tipos de autorização compatíveis:

Básico

Parâmetros adicionais de autorização necessários:

Nenhum

Documentação do Operata:

Como criar, visualizar, alterar e revogar tokens de API?

Integração do com a AWS usando o Agendador do Amazon EventBridge Pipes

Operações de API comumente usadas:

POST https://api.operata.io/v2/aws/events/contact-record

Informações adicionais:

O username é o ID do grupo Operata e a senha é seu token de API.

Salesforce

URL do endpoint de invocação de destino da API

Assunto: https:// myDomainName.my.salesforce.com/services/data/versionNumber/sobjects /SobjectEndpoint/*

Eventos de plataforma personalizados: https://myDomainName.my.salesforce.com/services/data /versionNumber/sobjects/customPlatformEndpoint/*

Para obter uma lista completa de endpoints, consulte Referência da API do Salesforce

Tipos de autorização compatíveis

Credenciais de cliente OAuth

Tokens OAUTH são atualizados quando uma resposta 401 ou 407 é exibida.

Parâmetros adicionais de autorização necessários

ID do cliente da aplicação Salesforce conectada e segredo do cliente.

Um dos seguintes endpoints de autorização:

  • Produção: https://MyDomainName.my.salesforce.com./services/oauth2/token

  • Sandbox com domínios aprimorados: https://MyDomainName-- SandboxName.my. salesforce.com/services /oauth2/token

  • Sandbox com domínios aprimorados: https://MyDomainName-- SandboxName.sandbox.my.salesforce.com/services/oauth2/token

O seguinte par de chave-valor:

Chave Valor

grant_type

client_credentials
Salesforce Documentação do

Guia do desenvolvedor da API REST

Operações de API comumente usadas

Como trabalhar com metadados de objeto

Trabalhar com registros

Mais informações

Para obter um tutorial explicando como usar o console do EventBridge para criar uma conexão ao Salesforce, um destino de API e uma regra para a qual encaminhar informações para o Salesforce, consulte Tutorial: enviar eventos ao Salesforce por meio do Amazon EventBridge.

Slack

URL do endpoint de invocação de destino da API

Para ver uma lista de endpoints e outros recursos, consulte Como usar a API Web do Slack

Tipos de autorização compatíveis

OAuth 2.0

Tokens OAUTH são atualizados quando uma resposta 401 ou 407 é exibida.

Ao criar uma aplicação Slack e a instala no seu espaço de trabalho, um token portador do OAuth será criado em seu nome para ser usado para autenticar chamadas pela sua conexão de destino da API.

Parâmetros adicionais de autorização necessários

Não aplicável

Slack Documentação do

Configuração básica da aplicação

Como instalar com OAuth

Como recuperar mensagens

Enviar mensagens

Como enviar mensagens usando webhooks de entrada

Operações de API comumente usadas

https://slack.com/api/chat.postMessage

Mais informações

Ao configurar sua regra do EventBridge, há duas configurações a serem destacadas:

  • Inclua um parâmetro de cabeçalho que defina o tipo de conteúdo como "application/json; charset=utf-8".

  • Use um transformador de entrada para mapear o evento de entrada para a saída esperada para a API do Slack, ou seja, certifique-se de que a carga enviada para a API do Slack tenha pares de chave/valor de "pipe" e "texto".

Shopify

URL do endpoint de invocação de destino da API

Para obter uma lista de endpoints e outros recursos e métodos, consulte Endpoints e solicitações.

Tipos de autorização compatíveis

OAuth, chave de API

nota

Tokens OAUTH são atualizados quando uma resposta 401 ou 407 é exibida.

Parâmetros adicionais de autorização necessários

Não aplicável

Shopify Documentação do

Visão geral de autenticação e autorização

Operações de API comumente usadas

POST - /admin/api/2022-01/products.json

GET - admin/api/2022-01/products/{product_id}.json

PUT - admin/api/2022-01/products/{product_id}.json

EXCLUIR: admin/api/2022-01/products/{product_id}.json

Mais informações

Crie uma aplicação

Entrega de webhook do Amazon EventBridge

Tokens de acesso para aplicações personalizadas no administrador da Shopify

Produto

Shopify API de administração da

Splunk

URL do endpoint de invocação de destino da API

https://SPLUNK_HEC_ENDPOINT:optional_port/services/collector/raw

Tipos de autorização compatíveis

Básico, chave de API

Parâmetros adicionais de autorização necessários

Nenhum

Splunk Documentação do

Para os dois tipos de autorização, você precisa de um ID de token HEC. Para obter mais informações, consulte Configurar e usar o Coletor de eventos HTTP no Splunk Web.

Operações de API comumente usadas

POST https://SPLUNK_HEC_ENDPOINT:optional_port/services/collector/raw

Mais informações

Chave de API: ao configurar o endpoint para o EventBridge, o nome da chave da API é "Autorização" e o valor é o ID do token Splunk HEC.

Básico (nome de usuário/senha): ao configurar o endpoint para o EventBridge, o nome de usuário é "Splunk" e a senha é o ID do token Splunk HEC.

Sumo Logic

URL do endpoint de invocação de destino da API

Os URLs do endpoint HTTP Log e Metric Source serão diferentes para cada usuário. Para obter mais informações, consulte Origem de logs e métricas HTTP.

Tipos de autorização compatíveis

O Sumo Logic não exige autenticação em suas origens HTTP porque há uma chave exclusiva embutida na URL. Por este motivo, é preciso tratar o URL como um segredo.

Ao configurar o destino da API EventBridge, é necessário um tipo de autorização. Para atender a esse requisito, selecione Chave de API e atribua a ela um nome de chave de "chave fictícia" e um valor de chave de "valor fictício".

Parâmetros adicionais de autorização necessários

Não aplicável

Sumo Logic Documentação do

O Sumo Logic já criou origens hospedadas para coletar registros e métricas de vários serviços da AWS e é possível usar as informações do site deles para trabalhar com essas origems. Para obter mais informações, consulte Amazon Web Services.

Se estiver gerando eventos personalizados de uma aplicação e quiser enviá-los como logs ou métricas Sumo Logic, use os destinos da API EventBridge e os endpoints Sumo Logic HTTP Log e Metric Source.

Operações de API comumente usadas

PUBLICAR https://endpoint4.collection.us2.sumologic.com/receiver/v1/http/UNIQUE_ID_PER_COLLECTOR

Mais informações

Nenhum

TriggerMesh

URL do endpoint de invocação de destino da API

Use as informações no tópico Origem do evento para HTTP para formular a URL do endpoint. Um URL de endpoint inclui o nome da origem do evento e o namespace do usuário no seguinte formato:

https://source-name.user-namespace.cloud.triggermesh.io

Inclui os parâmetros de autorização básicos na solicitação do endpoint.

Tipos de autorização compatíveis

Básico

Parâmetros adicionais de autorização necessários

Nenhum

TriggerMesh Documentação do

Origem do evento para HTTP

Operações de API comumente usadas

Não aplicável

Mais informações

Nenhum

Zendesk

URL do endpoint de invocação de destino da API

https://developer.zendesk.com/rest_api/docs/support/tickets

Tipos de autorização compatíveis

Básico, chave de API

Parâmetros adicionais de autorização necessários

Nenhum

Zendesk Documentação do

Segurança e autenticação

Operações de API comumente usadas

POST https://your_Zendesk_subdomain/api/v2/tickets

Mais informações

Solicitações de API: o EventBridge conta em relação aos seus limites de API do Zendesk. Para obter informações sobre os limites do Zendesk para seu plano, consulte Limites de uso.

Para proteger melhor sua conta e seus dados, recomendamos usar uma chave de API em vez da autenticação básica de credenciais de login.