Dynatrace
O Dynatrace fornece a melhor observabilidade na classe por meio de uma plataforma aberta e alimentada por IA. Esse conector contém os pontos de extremidade para a interface Dynatrace Problems.
Esse conector está disponível nos seguintes produtos e regiões:
| Service | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Aplicativos Lógicos | Standard | Todas as regiões dos Aplicativos Lógicos , exceto as seguintes: – Regiões do Azure Governamental - Regiões do Azure China - Departamento de Defesa dos EUA (DoD) |
| Power Apps | Premium | Todas as regiões do Power Apps , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Power Automate | Premium | Todas as regiões do Power Automate , exceto as seguintes: – Governo dos EUA (GCC) – Governo dos EUA (GCC High) - China Cloud operado pela 21Vianet - Departamento de Defesa dos EUA (DoD) |
| Contato | |
|---|---|
| Nome | Suporte ao Dynatrace |
| URL | https://www.dynatrace.com/services-support/ |
| microsoftalliances@dynatrace.com |
| Metadados do conector | |
|---|---|
| Publicador | Dynatrace |
| Site | https://www.dynatrace.com/ |
| Política de privacidade | https://www.dynatrace.com/company/trust-center/privacy/ |
| Categorias | IA; Business Intelligence |
O Dynatrace é líder em observabilidade de nuvem, usando IA e automação para monitorar e otimizar o desempenho do aplicativo, o desenvolvimento, a segurança, a experiência do usuário e muito mais. A IA Davis do Dynatrace fornece uma análise precisa da causa raiz dos problemas mais complexos de seus ambientes. Usando o conector do Dynatrace, você pode utilizar os insights da API de Problemas, Problemas de Segurança, Eventos e Métricas do Dynatrace para analisar os dados do ambiente para executar qualquer número de ações com os conectores disponíveis na biblioteca da Microsoft. Saiba mais sobre as APIs do Dynatrace aqui.
Pré-requisitos
Você precisará do seguinte para usar o conector:
Uma Plataforma de Inteligência de Software do Dynatrace. Para começar, clique aqui
Gere um token de acesso à API para a Plataforma Dynatrace com os seguintes escopos:
- Ler problemas
- Problemas de gravação
- Ler eventos
- Ingerir eventos
- Ler entites
- Ler problemas de segurança
Implante o OneAgent em pelo menos um aplicativo. Há exemplos de aplicativos e workshops para iniciar aplicativos com o Azure em seu locatário aqui
Como obter credenciais
- Você precisará de um locatário do Dynatrace e uma chave de API. Siga as instruções na seção Pré-requisitos para gerar ambos.
Introdução ao conector
- Criar um PowerApps, Um Fluxo do PowerAutomate ou um Aplicativo Lógico
- Enquanto estiver na seção de designer desses objetos, adicione o Conector Dynatrace.
- Você precisará inserir a URL do locatário e a chave de API para começar a usar o conector. Siga as instruções acima para obter ambos os itens.
- A URL do locatário que você inseriu deve estar no formato: abc123.dynatrace.com
- A chave de API deve ser inserida no formato: Api-Token dt1234. ABCDEFGH
Problemas e limitações conhecidos
Um usuário deve ter um Locatário do Dynatrace para usar esse conector
Erros e soluções comuns
- Verifique se o locatário inserido está no formato "abc123.dynatrace.com"
- Se você estiver recebendo erros de autenticação, certifique-se de ter gerado sua chave de API com os escopos adequados listados acima
perguntas frequentes
Serão atualizadas à medida que forem feitas perguntas.
Criando uma conexão
O conector dá suporte aos seguintes tipos de autenticação:
| Default | Parâmetros para criar conexão. | Todas as regiões | Não compartilhável |
Padrão
Aplicável: todas as regiões
Parâmetros para criar conexão.
Essa não é uma conexão compartilhável. Se o aplicativo de energia for compartilhado com outro usuário, outro usuário será solicitado a criar uma nova conexão explicitamente.
| Nome | Tipo | Description | Obrigatório |
|---|---|---|---|
| Chave de API | secureString | A chave de API para essa api (Api-Token dt1234. ABCDEFGH) | Verdade |
| Locatário do Dynatrace | cadeia | A URL do seu locatário. (abc123.dynatrace.com) | Verdade |
Limitações
| Nome | Chamadas | Período de renovação |
|---|---|---|
| Chamadas à API por conexão | 100 | 60 segundos |
Ações
| Ingestão de eventos pós-evento |
Ingere um evento personalizado |
| Obter comentário de problema por ID de problema e ID de comentário |
Obtém o comentário especificado sobre um problema. |
| Obter comentário de problema por ID do problema |
Obtém todos os comentários sobre o problema especificado |
| Obter entidade por ID |
Obtém as propriedades da entidade monitorada especificada |
| Obter entidades |
Obtém as informações sobre os entites monitorados |
| Obter eventos |
Lista eventos dentro do período de tempo especificado |
| Obter problema por ID |
Obtém as propriedades do problema especificado. |
| Obter problemas |
Lista os problemas observados dentro do período de tempo especificado. |
| Obter problemas de segurança |
Lista todos os problemas de segurança |
| Obter problemas de segurança por ID |
Obter parâmetros de problemas de segurança |
| Postar comentário de problema |
Adiciona um novo comentário sobre o problema especificado |
Ingestão de eventos pós-evento
Ingere um evento personalizado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
eventType
|
eventType | True | string |
Tipo de evento |
|
title
|
title | True | string |
Title |
|
startTime
|
startTime | string |
Hora de Início |
|
|
endTime
|
endTime | string |
Hora de Término |
|
|
tempo limite
|
timeout | integer |
Intervalo |
|
|
entitySelector
|
entitySelector | string |
Seletor de entidade |
|
|
propriedades
|
properties | object |
Propriedades |
Obter comentário de problema por ID de problema e ID de comentário
Obtém o comentário especificado sobre um problema.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do problema
|
problemId | True | string |
A ID do problema necessário |
|
ID do comentário
|
commentId | True | string |
A ID do comentário necessário |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
id
|
id | string |
ID do comentário |
|
createdAtTimestamp
|
createdAtTimestamp | integer |
Criado no Carimbo de Data/Hora |
|
conteúdo
|
content | string |
Conteúdo do Comentário |
|
authorName
|
authorName | string |
Nome do autor do comentário |
Obter comentário de problema por ID do problema
Obtém todos os comentários sobre o problema especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do problema
|
problemId | True | string |
ID do problema |
Obter entidade por ID
Obtém as propriedades da entidade monitorada especificada
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID da entidade
|
entityId | True | string |
A ID da entidade monitorada especificada |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
entityId
|
entityId | string |
ID da entidade |
|
tipo
|
type | string |
Tipo de entidade |
|
nome de exibição
|
displayName | string |
Nome de Exibição da Entidade |
|
primaryIconType
|
icon.primaryIconType | string |
Tipo de ícone primário |
|
secondaryIconType
|
icon.secondaryIconType | string |
Tipo de ícone secundário |
|
customIconPath
|
icon.customIconPath | string |
Caminho do ícone personalizado |
|
firstSeenTms
|
firstSeenTms | integer |
Tempos vistos pela primeira vez |
|
lastSeenTms
|
lastSeenTms | integer |
Tempos vistos pela última vez |
|
|
properties.bitness | string |
Bitness |
|
monitoringMode
|
properties.monitoringMode | string |
Modo de Monitoramento |
|
osType
|
properties.osType | string |
Tipo de sistema operacional |
|
osArchitecture
|
properties.osArchitecture | string |
Arquitetura do SO |
|
networkZoneId
|
properties.networkZoneId | string |
ID da zona de rede |
|
Núcleos de CPU
|
properties.cpuCores | integer |
Núcleos de CPU |
|
ipAddress
|
properties.ipAddress | array of string |
Endereço IP |
|
tags
|
tags | array of object |
Etiquetas |
|
contexto
|
tags.context | string |
Contexto da marca |
|
chave
|
tags.key | string |
Chave de marca |
|
value
|
tags.value | string |
Valor da marca |
|
stringRepresentation
|
tags.stringRepresentation | string |
Representação de cadeia de caracteres de marca |
|
managementZones
|
managementZones | array of object |
Zonas de gerenciamento |
|
id
|
managementZones.id | string |
ID da zona de gerenciamento |
|
nome
|
managementZones.name | string |
Nome da zona de gerenciamento |
|
isInstanceOf
|
fromRelationships.isInstanceOf | array of object |
É a instância de |
|
id
|
fromRelationships.isInstanceOf.id | string |
É a instância da ID |
|
tipo
|
fromRelationships.isInstanceOf.type | string |
É a instância do tipo |
|
isDiskOf
|
toRelationships.isDiskOf | array of object |
É disco de |
|
id
|
toRelationships.isDiskOf.id | string |
É disco de ID |
|
tipo
|
toRelationships.isDiskOf.type | string |
É o disco do tipo |
Obter entidades
Obtém as informações sobre os entites monitorados
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Seletor de entidade
|
entitySelector | True | string |
Define o escopo da consulta. Somente entidades que correspondem aos critérios especificados são incluídas em resposta. |
|
Intervalo de tempo
|
from | string |
O início do período de tempo solicitado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Contagem total |
|
pageSize
|
pageSize | integer |
Tamanho da Página |
|
nextPageKey
|
nextPageKey | string |
Próxima Chave de Página |
|
entities
|
entities | array of object |
Entities |
|
entityId
|
entities.entityId | string |
ID da entidade |
|
tipo
|
entities.type | string |
Tipo de entidade |
|
nome de exibição
|
entities.displayName | string |
Nome de Exibição da Entidade |
|
primaryIconType
|
entities.icon.primaryIconType | string |
Tipo de ícone primário |
|
secondaryIconType
|
entities.icon.secondaryIconType | string |
Tipo de ícone secundário |
|
customIconPath
|
entities.icon.customIconPath | string |
Caminho do ícone personalizado |
|
firstSeenTms
|
entities.firstSeenTms | integer |
Tempos vistos pela primeira vez |
|
lastSeenTms
|
entities.lastSeenTms | integer |
Tempos vistos pela última vez |
|
número de bit
|
entities.properties.bitness | integer |
Bitness |
|
monitoringMode
|
entities.properties.monitoringMode | string |
Modo de Monitoramento |
|
osType
|
entities.properties.osType | string |
Tipo de sistema operacional |
|
osArchitecture
|
entities.properties.osArchitecture | string |
Arquitetura do SO |
|
networkZoneId
|
entities.properties.networkZoneId | string |
ID da zona de rede |
|
Núcleos de CPU
|
entities.properties.cpuCores | integer |
Núcleos de CPU |
|
tags
|
entities.tags | array of object |
Etiquetas |
|
contexto
|
entities.tags.context | string |
Contexto da marca |
|
chave
|
entities.tags.key | string |
Chave de marca |
|
value
|
entities.tags.value | string |
Valor da marca |
|
stringRepresentation
|
entities.tags.stringRepresentation | string |
Representação de cadeia de caracteres de marca |
|
managementZones
|
entities.managementZones | array of object |
Zonas de gerenciamento |
|
id
|
entities.managementZones.id | string |
ID da zona de gerenciamento |
|
nome
|
entities.managementZones.name | string |
Nome da zona de gerenciamento |
|
isInstanceOf
|
entities.fromRelationships.isInstanceOf | array of object |
É a instância de |
|
id
|
entities.fromRelationships.isInstanceOf.id | string |
É a instância da ID |
|
tipo
|
entities.fromRelationships.isInstanceOf.type | string |
É a instância do tipo |
|
isDiskOf
|
entities.toRelationships.isDiskOf | array of object |
É disco de |
|
id
|
entities.toRelationships.isDiskOf.id | string |
É disco de ID |
|
tipo
|
entities.toRelationships.isDiskOf.type | string |
É o disco do tipo |
Obter eventos
Lista eventos dentro do período de tempo especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Período de Tempo
|
from | string |
O início do período de tempo solicitado. |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
Avisos
|
warnings | array of string |
Warnings |
|
events
|
events | array of object |
Eventos |
|
underMaintenance
|
events.underMaintenance | boolean |
Em Manutenção |
|
suppressAlert
|
events.suppressAlert | boolean |
Suprimir alerta |
|
suppressProblem
|
events.suppressProblem | boolean |
Suprimir problema |
|
frequentEvent
|
events.frequentEvent | boolean |
Evento frequente |
|
propriedades
|
events.properties | array of object |
Propriedades |
|
value
|
events.properties.value | string |
Valor da propriedade |
|
chave
|
events.properties.key | string |
Chave de propriedade |
|
correlationId
|
events.correlationId | string |
ID de Correlação |
|
status
|
events.status | string |
Situação |
|
startTime
|
events.startTime | integer |
Hora de Início |
|
endTime
|
events.endTime | integer |
Hora de Término |
|
title
|
events.title | string |
Title |
|
eventType
|
events.eventType | string |
Tipo de evento |
|
managementZones
|
events.managementZones | array of object |
Zonas de gerenciamento |
|
nome
|
events.managementZones.name | string |
Nome da zona de gerenciamento |
|
id
|
events.managementZones.id | string |
ID da zona de gerenciamento |
|
eventId
|
events.eventId | string |
ID do evento |
|
entityTags
|
events.entityTags | array of object |
Marcas de entidade |
|
stringRepresentation
|
events.entityTags.stringRepresentation | string |
Representação da cadeia de caracteres de marca de entidade |
|
value
|
events.entityTags.value | string |
Valor da marca de entidade |
|
chave
|
events.entityTags.key | string |
Chave de marca de entidade |
|
contexto
|
events.entityTags.context | string |
Contexto da marca de entidade |
|
id
|
events.entityId.entityId.id | string |
ID da entidade |
|
tipo
|
events.entityId.entityId.type | string |
Tipo de entidade |
|
nome
|
events.entityId.name | string |
Nome da Entidade |
|
nextPageKey
|
nextPageKey | string |
Próxima Chave de Página |
|
totalCount
|
totalCount | integer |
Contagem total |
|
pageSize
|
pageSize | integer |
Tamanho da Página |
Obter problema por ID
Obtém as propriedades do problema especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do problema
|
problem_id | True | string |
A ID do problema necessário |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
details
|
evidenceDetails.details | array of object |
Detalhes |
|
tipo de evidência
|
evidenceDetails.details.evidenceType | string |
Tipo de evidência |
|
nome de exibição
|
evidenceDetails.details.displayName | string |
Nome de Exibição |
|
id
|
evidenceDetails.details.entity.entityId.id | string |
ID da entidade de evidência |
|
tipo
|
evidenceDetails.details.entity.entityId.type | string |
Tipo de entidade de evidência |
|
nome
|
evidenceDetails.details.entity.name | string |
Nome da entidade de evidência |
|
id
|
evidenceDetails.details.groupingEntity.entityId.id | string |
ID da entidade de agrupamento |
|
tipo
|
evidenceDetails.details.groupingEntity.entityId.type | string |
Tipo de entidade de agrupamento |
|
nome
|
evidenceDetails.details.groupingEntity.name | string |
Nome da entidade de agrupamento |
|
rootCauseRelevant
|
evidenceDetails.details.rootCauseRelevant | boolean |
Causa raiz relevante |
|
startTime
|
evidenceDetails.details.startTime | integer |
Hora de início dos detalhes da evidência |
|
totalCount
|
evidenceDetails.totalCount | integer |
Contagem total de detalhes da evidência |
|
comments
|
recentComments.comments | array of object |
Comments |
|
authorName
|
recentComments.comments.authorName | string |
Nome do autor de comentários recentes |
|
createdAtTimestamp
|
recentComments.comments.createdAtTimestamp | integer |
Comentários recentes criados no carimbo de data/hora |
|
contexto
|
recentComments.comments.context | string |
Contexto de comentários recentes |
|
id
|
recentComments.comments.id | string |
ID de Comentários Recentes |
|
conteúdo
|
recentComments.comments.content | string |
Conteúdo de Comentários Recentes |
|
pageSize
|
recentComments.pageSize | integer |
Tamanho da página Comentários Recentes |
|
nextPageKey
|
recentComments.nextPageKey | string |
Chave da Próxima Página de Comentários Recentes |
|
totalCount
|
recentComments.totalCount | integer |
Contagem total de comentários recentes |
|
displayId
|
linkedProblemInfo.displayId | string |
ID de exibição de problema vinculado |
|
problemId
|
linkedProblemInfo.problemId | string |
ID do problema vinculado |
|
id
|
rootCauseEntity.entityId.id | string |
ID da entidade de causa raiz |
|
tipo
|
rootCauseEntity.entityId.type | string |
Tipo de entidade de causa raiz |
|
nome
|
rootCauseEntity.name | string |
Nome da entidade de causa raiz |
|
impactedEntities
|
impactedEntities | array of object |
Entidades afetadas |
|
id
|
impactedEntities.entityId.id | string |
ID da entidade afetada |
|
tipo
|
impactedEntities.entityId.type | string |
Tipo de entidade afetado |
|
nome
|
impactedEntities.name | string |
Nome da entidade afetada |
|
Impactos
|
impactAnalysis.impacts | array of object |
Impactos |
|
impactType
|
impactAnalysis.impacts.impactType | string |
Tipo de impacto |
|
id
|
impactAnalysis.impacts.impactedEntity.entityId.id | string |
ID da entidade afetada |
|
tipo
|
impactAnalysis.impacts.impactedEntity.entityId.type | string |
Tipo de entidade afetado |
|
nome
|
impactAnalysis.impacts.impactedEntity.name | string |
Nome da entidade afetada |
|
estimatedAffectedUsers
|
impactAnalysis.impacts.estimatedAffectedUsers | integer |
Usuários afetados estimados |
|
problemFilters
|
problemFilters | array of object |
Filtros de problema |
|
nome
|
problemFilters.name | string |
Nome dos Filtros de Problema |
|
id
|
problemFilters.id | string |
ID de Filtros de Problema |
|
impactLevel
|
impactLevel | string |
Nível de impacto |
|
displayId
|
displayId | string |
ID de exibição |
|
affectedEntities
|
affectedEntities | array of object |
Entidades afetadas |
|
id
|
affectedEntities.entityId.id | string |
ID da entidade afetada |
|
tipo
|
affectedEntities.entityId.type | string |
Tipo de entidade afetado |
|
nome
|
affectedEntities.name | string |
Nome da entidade afetada |
|
managementZones
|
managementZones | array of object |
Zonas de gerenciamento |
|
nome
|
managementZones.name | string |
Nome da zona de gerenciamento |
|
id
|
managementZones.id | string |
ID da zona de gerenciamento |
|
severityLevel
|
severityLevel | string |
Nível de severidade |
|
entityTags
|
entityTags | array of object |
Marcas de entidade |
|
stringRepresentation
|
entityTags.stringRepresentation | string |
Representação da cadeia de caracteres de marca de entidade |
|
value
|
entityTags.value | string |
Valor da marca de entidade |
|
chave
|
entityTags.key | string |
Chave de marca de entidade |
|
contexto
|
entityTags.context | string |
Contexto da marca de entidade |
|
problemId
|
problemId | string |
ID do problema |
|
status
|
status | string |
Situação |
|
startTime
|
startTime | integer |
Hora de Início |
|
endTime
|
endTime | integer |
Hora de Término |
|
title
|
title | string |
Title |
Obter problemas
Lista os problemas observados dentro do período de tempo especificado.
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Intervalo de tempo
|
from | string |
Intervalo da consulta. Exemplo: 'now-1d' |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Contagem total |
|
pageSize
|
pageSize | integer |
Tamanho da Página |
|
nextPageKey
|
nextPageKey | string |
Próxima Chave de Página |
|
Problemas
|
problems | array of object |
Problemas |
|
affectedEntities
|
problems.affectedEntities | array of object |
Entidades afetadas |
|
id
|
problems.affectedEntities.entityId.id | string |
ID da entidade afetada |
|
tipo
|
problems.affectedEntities.entityId.type | string |
Tipo de entidade afetado |
|
nome
|
problems.affectedEntities.name | string |
Nome da entidade afetada |
|
displayId
|
problems.displayId | string |
ID de exibição |
|
impactedEntities
|
problems.impactedEntities | array of object |
Entidades afetadas |
|
id
|
problems.impactedEntities.entityId.id | string |
ID da entidade afetada |
|
tipo
|
problems.impactedEntities.entityId.type | string |
Tipo de entidade afetado |
|
nome
|
problems.impactedEntities.name | string |
Nome da entidade afetada |
|
displayId
|
problems.linkedProblemInfo.displayId | string |
ID de exibição de problema vinculado |
|
problemId
|
problems.linkedProblemInfo.problemId | string |
ID do problema vinculado |
|
problemFilters
|
problems.problemFilters | array of object |
Filtros de problema |
|
nome
|
problems.problemFilters.name | string |
Nome do filtro de problema |
|
id
|
problems.problemFilters.id | string |
ID do filtro de problema |
|
totalCount
|
problems.evidenceDetails.totalCount | integer |
Contagem total |
|
details
|
problems.evidenceDetails.details | array of object |
Detalhes |
|
tipo de evidência
|
problems.evidenceDetails.details.evidenceType | string |
Tipo de evidência |
|
nome de exibição
|
problems.evidenceDetails.details.displayName | string |
Nome de Exibição |
|
id
|
problems.evidenceDetails.details.entity.entityId.id | string |
ID da entidade de detalhes da evidência |
|
tipo
|
problems.evidenceDetails.details.entity.entityId.type | string |
Tipo de entidade de detalhes de evidência |
|
nome
|
problems.evidenceDetails.details.entity.name | string |
Nome da entidade de detalhes da evidência |
|
id
|
problems.evidenceDetails.details.groupingEntity.entityId.id | string |
ID da entidade de agrupamento |
|
tipo
|
problems.evidenceDetails.details.groupingEntity.entityId.type | string |
Tipo de entidade de agrupamento |
|
nome
|
problems.evidenceDetails.details.groupingEntity.name | string |
Nome da entidade de agrupamento |
|
rootCauseRelevant
|
problems.evidenceDetails.details.rootCauseRelevant | boolean |
Causa raiz relevante |
|
startTime
|
problems.evidenceDetails.details.startTime | integer |
StartTime de Detalhes da Evidência |
|
comments
|
problems.recentComments.comments | array of object |
Comments |
|
createdAtTimestamp
|
problems.recentComments.comments.createdAtTimestamp | integer |
Comentário criado no carimbo de data/hora |
|
authorName
|
problems.recentComments.comments.authorName | string |
Nome do autor do comentário |
|
contexto
|
problems.recentComments.comments.context | string |
Contexto de comentário |
|
id
|
problems.recentComments.comments.id | string |
ID do comentário |
|
conteúdo
|
problems.recentComments.comments.content | string |
Conteúdo do Comentário |
|
pageSize
|
problems.recentComments.pageSize | integer |
PageSize |
|
nextPageKey
|
problems.recentComments.nextPageKey | string |
Próxima Chave de Página |
|
totalCount
|
problems.recentComments.totalCount | integer |
Contagem total |
|
Impactos
|
problems.impactAnalysis.impacts | array of object |
Impactos |
|
impactType
|
problems.impactAnalysis.impacts.impactType | string |
Tipo de impacto |
|
id
|
problems.impactAnalysis.impacts.impactedEntity.entityId.id | string |
ID da entidade afetada |
|
tipo
|
problems.impactAnalysis.impacts.impactedEntity.entityId.type | string |
Tipo de entidade afetado |
|
nome
|
problems.impactAnalysis.impacts.impactedEntity.name | string |
Nome da entidade afetada |
|
estimatedAffectedUsers
|
problems.impactAnalysis.impacts.estimatedAffectedUsers | integer |
Usuários afetados estimados |
|
id
|
problems.rootCauseEntity.entityId.id | string |
ID da entidade de causa raiz |
|
tipo
|
problems.rootCauseEntity.entityId.type | string |
Tipo de causa raiz |
|
nome
|
problems.rootCauseEntity.name | string |
Nome da entidade de causa raiz |
|
managementZones
|
problems.managementZones | array of object |
Zonas de gerenciamento |
|
nome
|
problems.managementZones.name | string |
Nome da zona de gerenciamento |
|
id
|
problems.managementZones.id | string |
ID da zona de gerenciamento |
|
severityLevel
|
problems.severityLevel | string |
Nível de severidade |
|
entityTags
|
problems.entityTags | array of object |
Marcas de entidade |
|
stringRepresentation
|
problems.entityTags.stringRepresentation | string |
Representação da cadeia de caracteres de marca de entidade |
|
value
|
problems.entityTags.value | string |
Valor da marca de entidade |
|
chave
|
problems.entityTags.key | string |
Chave de marca de entidade |
|
contexto
|
problems.entityTags.context | string |
Contexto da marca de entidade |
|
problemId
|
problems.problemId | string |
ID do problema |
|
impactLevel
|
problems.impactLevel | string |
Nível de impacto |
|
status
|
problems.status | string |
Situação |
|
startTime
|
problems.startTime | integer |
Hora de Início |
|
endTime
|
problems.endTime | integer |
Hora de Término |
|
title
|
problems.title | string |
Title |
|
Avisos
|
warnings | array of string |
Warnings |
Obter problemas de segurança
Lista todos os problemas de segurança
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
Seletor de problemas de segurança
|
securityProblemSelector | string |
Define o escopo da consulta. Somente os problemas de segurança que correspondem aos critérios especificados são incluídos na resposta |
|
|
Intervalo de tempo
|
from | string |
O início do período de tempo solicitado |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Contagem total |
|
pageSize
|
pageSize | integer |
Tamanho da Página |
|
nextPageKey
|
nextPageKey | string |
Próxima Chave de Página |
|
securityProblems
|
securityProblems | array of object |
Problemas de segurança |
|
securityProblemId
|
securityProblems.securityProblemId | string |
ID do problema de segurança |
|
displayId
|
securityProblems.displayId | string |
ID de exibição |
|
status
|
securityProblems.status | string |
Situação |
|
abafado
|
securityProblems.muted | boolean |
Abafado |
|
externalVulnerabilityId
|
securityProblems.externalVulnerabilityId | string |
ID de vulnerabilidade externa |
|
vulnerabilityType
|
securityProblems.vulnerabilityType | string |
Tipo de vulnerabilidade |
|
title
|
securityProblems.title | string |
Title |
|
packageName
|
securityProblems.packageName | string |
Nome do Pacote |
|
url
|
securityProblems.url | string |
URL |
|
Tecnologia
|
securityProblems.technology | string |
Tecnologia |
|
firstSeenTimestamp
|
securityProblems.firstSeenTimestamp | integer |
Carimbo de data/hora visto pela primeira vez |
|
lastUpdatedTimestamp
|
securityProblems.lastUpdatedTimestamp | integer |
Carimbo de data/hora última atualização |
|
riskLevel
|
securityProblems.riskAssessment.riskLevel | string |
Nível de risco |
|
riskScore
|
securityProblems.riskAssessment.riskScore | integer |
Pontuação de risco |
|
riskVector
|
securityProblems.riskAssessment.riskVector | string |
Vetor de risco |
|
baseRiskLevel
|
securityProblems.riskAssessment.baseRiskLevel | string |
Nível de risco base |
|
baseRiskScore
|
securityProblems.riskAssessment.baseRiskScore | integer |
Pontuação de risco base |
|
baseRiskVector
|
securityProblems.riskAssessment.baseRiskVector | string |
Vetor de risco base |
|
exposição
|
securityProblems.riskAssessment.exposure | string |
Exposição |
|
dataAssets
|
securityProblems.riskAssessment.dataAssets | string |
Ativos de dados |
|
publicExploit
|
securityProblems.riskAssessment.publicExploit | string |
Exploração Pública |
|
vulnerableFunctionUsage
|
securityProblems.riskAssessment.vulnerableFunctionUsage | string |
Uso de função vulnerável |
|
managementZones
|
securityProblems.managementZones | array of object |
Zonas de gerenciamento |
|
nome
|
securityProblems.managementZones.name | string |
Nome da zona de gerenciamento |
|
id
|
securityProblems.managementZones.id | string |
ID da zona de gerenciamento |
|
cveIds
|
securityProblems.cveIds | array of string |
CVE IDs |
Obter problemas de segurança por ID
Obter parâmetros de problemas de segurança
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do problema do Secuirty
|
id | True | string |
A ID do problema de segurança especificado |
|
Fields
|
fields | string |
Uma lista de propriedades de problema de segurança adicionais que você pode adicionar à resposta. Para adicionar propriedades, especifique-as em uma lista separada por vírgulas e prefixe cada propriedade com uma adição (por exemplo, +riskAssessment,+managementZones). |
Retornos
| Nome | Caminho | Tipo | Description |
|---|---|---|---|
|
securityProblemId
|
securityProblemId | string |
ID do problema de segurança |
|
displayId
|
displayId | string |
ID de exibição |
|
status
|
status | string |
Situação |
|
abafado
|
muted | boolean |
Abafado |
|
externalVulnerabilityId
|
externalVulnerabilityId | string |
ID de vulnerabilidade externa |
|
vulnerabilityType
|
vulnerabilityType | string |
Tipo de vulnerabilidade |
|
title
|
title | string |
Title |
|
packageName
|
packageName | string |
Nome do Pacote |
|
url
|
url | string |
URL |
|
descrição
|
description | string |
Description |
|
Tecnologia
|
technology | string |
Tecnologia |
|
firstSeenTimestamp
|
firstSeenTimestamp | integer |
Carimbo de data/hora visto pela primeira vez |
|
lastUpdatedTimestamp
|
lastUpdatedTimestamp | integer |
Carimbo de data/hora última atualização |
|
riskLevel
|
riskAssessment.riskLevel | string |
Nível de risco |
|
|
riskAssessment.riskScore | float |
Pontuação de risco |
|
riskVector
|
riskAssessment.riskVector | string |
Vetor de risco |
|
baseRiskLevel
|
riskAssessment.baseRiskLevel | string |
Nível de risco base |
|
|
riskAssessment.baseRiskScore | float |
Pontuação de risco base |
|
baseRiskVector
|
riskAssessment.baseRiskVector | string |
Vetor de risco base |
|
exposição
|
riskAssessment.exposure | string |
Exposição |
|
dataAssets
|
riskAssessment.dataAssets | string |
Ativos de dados |
|
publicExploit
|
riskAssessment.publicExploit | string |
Exploração Pública |
|
vulnerableFunctionUsage
|
riskAssessment.vulnerableFunctionUsage | string |
Uso de função vulnerável |
|
managementZones
|
managementZones | array of object |
Zonas de gerenciamento |
|
nome
|
managementZones.name | string |
Nome da zona de gerenciamento |
|
id
|
managementZones.id | string |
ID da zona de gerenciamento |
|
cveIds
|
cveIds | array of string |
CVE IDs |
|
events
|
events | array of object |
Eventos |
|
carimbo de data/hora
|
events.timestamp | integer |
Timestamp do evento |
|
reason
|
events.reason | string |
Motivo do evento |
|
numberOfAffectedEntities
|
events.riskAssessmentSnapshot.numberOfAffectedEntities | integer |
Número de entidades afetadas |
|
numberOfReachableDataAssets
|
events.riskAssessmentSnapshot.numberOfReachableDataAssets | integer |
Número de ativos de dados acessíveis |
|
publicExploit
|
events.riskAssessmentSnapshot.publicExploit | string |
Exploração Pública |
|
exposição
|
events.riskAssessmentSnapshot.exposure | string |
Exposição |
|
vulnerableFunctionUsage
|
events.riskAssessmentSnapshot.vulnerableFunctionUsage | string |
Uso de função vulnerável |
|
usuário
|
events.muteState.user | string |
Ativar mudo de usuário de estado |
|
reason
|
events.muteState.reason | string |
Motivo do estado do mudo |
|
comentário
|
events.muteState.comment | string |
Ativar mudo de comentário de estado |
|
vulnerableComponents
|
vulnerableComponents | array of object |
Componentes vulneráveis |
|
id
|
vulnerableComponents.id | string |
ID de componentes vulneráveis |
|
nome de exibição
|
vulnerableComponents.displayName | string |
Nome de Exibição de Componenets Vulneráveis |
|
fileName
|
vulnerableComponents.fileName | string |
Nome do arquivo componentes vulneráveis |
|
numberOfAffectedEntities
|
vulnerableComponents.numberOfAffectedEntities | integer |
Número de entidades afetadas de componentes vulneráveis |
|
affectedEntities
|
vulnerableComponents.affectedEntities | array of string |
Entidades afetadas |
|
affectedEntities
|
affectedEntities | array of string |
Entidades afetadas |
|
exposedEntities
|
exposedEntities | array of string |
Entidades expostas |
|
reachableDataAssets
|
reachableDataAssets | array of string |
Ativos de dados acessíveis |
|
applications
|
relatedEntities.applications | array of object |
Aplicativos |
|
id
|
relatedEntities.applications.id | string |
ID do aplicativo |
|
numberOfAffectedEntities
|
relatedEntities.applications.numberOfAffectedEntities | integer |
Número do aplicativo de entidades afetadas |
|
affectedEntities
|
relatedEntities.applications.affectedEntities | array of string |
Entidades afetadas pelo aplicativo |
|
services
|
relatedEntities.services | array of object |
Services |
|
id
|
relatedEntities.services.id | string |
ID do Serviço |
|
numberOfAffectedEntities
|
relatedEntities.services.numberOfAffectedEntities | integer |
Número de serviço de entidades afetadas |
|
affectedEntities
|
relatedEntities.services.affectedEntities | array of string |
Entidades afetadas pelo serviço |
|
exposição
|
relatedEntities.services.exposure | string |
Exposição |
|
hosts
|
relatedEntities.hosts | array of object |
Hosts |
|
id
|
relatedEntities.hosts.id | string |
Host ID |
|
numberOfAffectedEntities
|
relatedEntities.hosts.numberOfAffectedEntities | integer |
Número de host de entidades afetadas |
|
affectedEntities
|
relatedEntities.hosts.affectedEntities | array of string |
Entidades afetadas pelo host |
|
bancos de dados
|
relatedEntities.databases | array of string |
Databases |
|
kubernetesWorkloads
|
relatedEntities.kubernetesWorkloads | array of object |
Cargas de trabalho do Kubernetes |
|
id
|
relatedEntities.kubernetesWorkloads.id | string |
ID da carga de trabalho do Kubernetes |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesWorkloads.numberOfAffectedEntities | integer |
Número de carga de trabalho do Kubernetes de entidades afetadas |
|
affectedEntities
|
relatedEntities.kubernetesWorkloads.affectedEntities | array of string |
Entidades afetadas pela carga de trabalho do Kubernetes |
|
kubernetesClusters
|
relatedEntities.kubernetesClusters | array of object |
Kubernetes Clusters |
|
id
|
relatedEntities.kubernetesClusters.id | string |
Kubernetes Cluster ID |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesClusters.numberOfAffectedEntities | integer |
Número de entidades afetadas do Kubernetes Cluder |
|
affectedEntities
|
relatedEntities.kubernetesClusters.affectedEntities | array of string |
Entidades afetadas pelo cluster do Kubernetes |
|
containerImages
|
relatedContainerImages.containerImages | array of object |
Imagens de contêiner |
|
imageId
|
relatedContainerImages.containerImages.imageId | string |
ID da imagem de contêiner relacionada |
|
nome_da_imagem
|
relatedContainerImages.containerImages.imageName | string |
Nome da imagem do contêiner relacionado |
|
numberOfAffectedEntities
|
relatedContainerImages.containerImages.numberOfAffectedEntities | integer |
Número de contêiner relacionado de entidades afetadas |
|
affectedEntities
|
relatedContainerImages.containerImages.affectedEntities | array of string |
Entidades afetadas pelo contêiner relacionado |
|
muteStateChangeInProgress
|
muteStateChangeInProgress | boolean |
Alterar o estado do mudo em andamento |
Postar comentário de problema
Adiciona um novo comentário sobre o problema especificado
Parâmetros
| Nome | Chave | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
ID do problema
|
problemId | True | string |
ID do problema |
|
mensagem
|
message | string |
Message |
|
|
contexto
|
context | string |
Contexto |