Dynatrace
Platforma Dynatrace zapewnia najlepszą w klasie możliwość obserwacji za pośrednictwem otwartej platformy opartej na sztucznej inteligencji. Ten łącznik zawiera punkty końcowe interfejsu Dynatrace Problems.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Obsługa rozwiązania Dynatrace |
| adres URL | https://www.dynatrace.com/services-support/ |
| microsoftalliances@dynatrace.com |
| Metadane łącznika | |
|---|---|
| Publisher | Dynatrace |
| Witryna internetowa | https://www.dynatrace.com/ |
| Zasady ochrony prywatności | https://www.dynatrace.com/company/trust-center/privacy/ |
| Kategorie | AI; Analiza biznesowa |
Dynatrace jest liderem w zakresie wglądu w chmurę, wykorzystując sztuczną inteligencję i automatyzację do monitorowania i optymalizowania wydajności aplikacji, programowania, zabezpieczeń, środowiska użytkownika i nie tylko. Dynatrace Davis AI zapewnia dokładną analizę głównych przyczyn najbardziej złożonych problemów środowiska. Korzystając z łącznika Dynatrace, możesz użyć szczegółowych informacji z interfejsu API Problemy, Problemy z zabezpieczeniami, Zdarzenia i Metryki, aby przeanalizować dane środowiska, aby wykonać dowolną liczbę akcji z dostępnymi łącznikami w bibliotece firmy Microsoft. Dowiedz się więcej o interfejsach API dynatrace tutaj.
Wymagania wstępne
Aby użyć łącznika, potrzebne będą następujące elementy:
A Dynatrace Software Intelligence Platform. Aby rozpocząć pracę, kliknij tutaj
Wygeneruj token dostępu interfejsu API do platformy Dynatrace z następującymi zakresami:
- Problemy z odczytem
- Problemy z zapisem
- Odczytywanie zdarzeń
- Pozyskiwanie zdarzeń
- Odczytaj entites
- Odczytywanie problemów z zabezpieczeniami
Wdróż usługę OneAgent w aplikacji co najmniej. Przykładowe aplikacje i warsztaty dotyczące uruchamiania aplikacji za pomocą platformy Azure w dzierżawie są dostępne tutaj
Jak uzyskać poświadczenia
- Będziesz potrzebować dzierżawy Dynatrace i klucza interfejsu API. Postępuj zgodnie z instrukcjami w sekcji Wymagania wstępne, aby wygenerować oba te elementy.
Wprowadzenie do łącznika
- Tworzenie usługi PowerApps, usługi PowerAutomate Flow lub aplikacji logiki
- W sekcji projektanta tych obiektów dodaj łącznik Dynatrace.
- Aby rozpocząć korzystanie z łącznika, musisz wprowadzić adres URL dzierżawy i klucz interfejsu API. Postępuj zgodnie z powyższymi instrukcjami, aby pobrać oba elementy.
- Adres URL dzierżawy, który należy wprowadzić, powinien mieć format: abc123.dynatrace.com
- Klucz interfejsu API należy wprowadzić w formacie: Api-Token dt1234. ABCDEFGH
Znane problemy i ograniczenia
Aby móc korzystać z tego łącznika, użytkownik musi mieć dzierżawę Dynatrace
Typowe błędy i środki zaradcze
- Upewnij się, że dzierżawa wejściowa ma format "abc123.dynatrace.com"
- Jeśli występują błędy uwierzytelniania, upewnij się, że wygenerowano klucz interfejsu API z odpowiednimi zakresami wymienionymi powyżej
Często zadawane pytania
Zostanie zaktualizowany w miarę zadawanych pytań.
Tworzenie połączenia
Łącznik obsługuje następujące typy uwierzytelniania:
| Wartość domyślna | Parametry tworzenia połączenia. | Wszystkie regiony | Nie można udostępniać |
Domyślny
Dotyczy: wszystkie regiony
Parametry tworzenia połączenia.
Nie jest to możliwe do udostępnienia połączenie. Jeśli aplikacja power zostanie udostępniona innemu użytkownikowi, zostanie wyświetlony monit o jawne utworzenie nowego połączenia.
| Name | Typ | Description | Wymagane |
|---|---|---|---|
| Klucz interfejsu API | securestring | Klucz interfejsu API dla tego interfejsu API (Api-Token dt1234. ABCDEFGH) | Prawda |
| Dzierżawa dynatrace | ciąg | Adres URL dzierżawy. (abc123.dynatrace.com) | Prawda |
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Opublikuj komentarz dotyczący problemu |
Dodaje nowy komentarz dotyczący określonego problemu |
| Po pozyskiwaniu zdarzeń |
Pozyskiwanie zdarzenia niestandardowego |
| Pobieranie jednostek |
Pobiera informacje o monitorowanychentach |
| Pobieranie jednostki według identyfikatora |
Pobiera właściwości określonej monitorowanej jednostki |
| Pobieranie wydarzeń |
Wyświetla listę zdarzeń w określonym przedziale czasu |
| Uzyskiwanie komentarza problemu według identyfikatora problemu |
Pobiera wszystkie komentarze dotyczące określonego problemu |
| Uzyskiwanie komentarza problemu według identyfikatora problemu i identyfikatora komentarza |
Pobiera określony komentarz dotyczący problemu. |
| Uzyskiwanie problemu według identyfikatora |
Pobiera właściwości określonego problemu. |
| Uzyskiwanie problemów |
Wyświetla listę problemów zaobserwowanych w określonym przedziale czasu. |
| Uzyskiwanie problemów z zabezpieczeniami |
Wyświetla listę wszystkich problemów z zabezpieczeniami |
| Uzyskiwanie problemów z zabezpieczeniami według identyfikatora |
Pobieranie parametrów problemów z zabezpieczeniami |
Opublikuj komentarz dotyczący problemu
Dodaje nowy komentarz dotyczący określonego problemu
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator problemu
|
problemId | True | string |
Identyfikator problemu |
|
komunikat
|
message | string |
Message |
|
|
kontekst
|
context | string |
Context |
Po pozyskiwaniu zdarzeń
Pozyskiwanie zdarzenia niestandardowego
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
eventType
|
eventType | True | string |
Typ zdarzenia |
|
title
|
title | True | string |
Title |
|
startTime
|
startTime | string |
Godzina rozpoczęcia |
|
|
endTime
|
endTime | string |
Godzina zakończenia |
|
|
przerwa czasowa
|
timeout | integer |
Przerwa czasowa |
|
|
entitySelector
|
entitySelector | string |
Selektor jednostek |
|
|
properties
|
properties | object |
Właściwości |
Pobieranie jednostek
Pobiera informacje o monitorowanychentach
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Selektor jednostek
|
entitySelector | True | string |
Definiuje zakres zapytania. Tylko jednostki spełniające określone kryteria są uwzględniane w odpowiedzi. |
|
Przedział czasu
|
from | string |
Początek żądanego przedziału czasu. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Łączna liczba |
|
pageSize
|
pageSize | integer |
Rozmiar strony |
|
nextPageKey
|
nextPageKey | string |
Następny klucz strony |
|
entities
|
entities | array of object |
Entities |
|
entityId
|
entities.entityId | string |
Identyfikator jednostki |
|
typ
|
entities.type | string |
Typ jednostki |
|
nazwa wyświetlana
|
entities.displayName | string |
Nazwa wyświetlana jednostki |
|
primaryIconType
|
entities.icon.primaryIconType | string |
Typ ikony podstawowej |
|
secondaryIconType
|
entities.icon.secondaryIconType | string |
Typ ikony pomocniczej |
|
customIconPath
|
entities.icon.customIconPath | string |
Ścieżka ikony niestandardowej |
|
firstSeenTms
|
entities.firstSeenTms | integer |
Pierwszy raz widziany razy |
|
lastSeenTms
|
entities.lastSeenTms | integer |
Czas ostatniego zobaczenia |
|
liczba bitów
|
entities.properties.bitness | integer |
Bitness (Bitness) |
|
monitoringMode
|
entities.properties.monitoringMode | string |
Tryb monitorowania |
|
osType
|
entities.properties.osType | string |
Typ systemu operacyjnego |
|
osArchitecture
|
entities.properties.osArchitecture | string |
Architektura systemu operacyjnego |
|
networkZoneId
|
entities.properties.networkZoneId | string |
Identyfikator strefy sieciowej |
|
rdzenie procesora CPU
|
entities.properties.cpuCores | integer |
Rdzenie procesora CPU |
|
tags
|
entities.tags | array of object |
Etykiety |
|
kontekst
|
entities.tags.context | string |
Kontekst tagu |
|
klucz
|
entities.tags.key | string |
Klucz tagu |
|
value
|
entities.tags.value | string |
Wartość tagu |
|
stringRepresentation
|
entities.tags.stringRepresentation | string |
Reprezentacja ciągu tagu |
|
managementZones
|
entities.managementZones | array of object |
Strefy zarządzania |
|
id
|
entities.managementZones.id | string |
Identyfikator strefy zarządzania |
|
nazwa
|
entities.managementZones.name | string |
Nazwa strefy zarządzania |
|
isInstanceOf
|
entities.fromRelationships.isInstanceOf | array of object |
Jest wystąpieniem |
|
id
|
entities.fromRelationships.isInstanceOf.id | string |
Jest wystąpieniem identyfikatora |
|
typ
|
entities.fromRelationships.isInstanceOf.type | string |
Jest wystąpieniem typu |
|
isDiskOf
|
entities.toRelationships.isDiskOf | array of object |
Jest dyskiem |
|
id
|
entities.toRelationships.isDiskOf.id | string |
Czy dysk o identyfikatorze |
|
typ
|
entities.toRelationships.isDiskOf.type | string |
Czy dysk typu |
Pobieranie jednostki według identyfikatora
Pobiera właściwości określonej monitorowanej jednostki
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator jednostki
|
entityId | True | string |
Identyfikator określonej monitorowanej jednostki |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
entityId
|
entityId | string |
Identyfikator jednostki |
|
typ
|
type | string |
Typ jednostki |
|
nazwa wyświetlana
|
displayName | string |
Nazwa wyświetlana jednostki |
|
primaryIconType
|
icon.primaryIconType | string |
Typ ikony podstawowej |
|
secondaryIconType
|
icon.secondaryIconType | string |
Typ ikony pomocniczej |
|
customIconPath
|
icon.customIconPath | string |
Ścieżka ikony niestandardowej |
|
firstSeenTms
|
firstSeenTms | integer |
Pierwszy raz widziany razy |
|
lastSeenTms
|
lastSeenTms | integer |
Czas ostatniego zobaczenia |
|
|
properties.bitness | string |
Bitness (Bitness) |
|
monitoringMode
|
properties.monitoringMode | string |
Tryb monitorowania |
|
osType
|
properties.osType | string |
Typ systemu operacyjnego |
|
osArchitecture
|
properties.osArchitecture | string |
Architektura systemu operacyjnego |
|
networkZoneId
|
properties.networkZoneId | string |
Identyfikator strefy sieciowej |
|
rdzenie procesora CPU
|
properties.cpuCores | integer |
Rdzenie procesora CPU |
|
ipAddress
|
properties.ipAddress | array of string |
Adres IP |
|
tags
|
tags | array of object |
Etykiety |
|
kontekst
|
tags.context | string |
Kontekst tagu |
|
klucz
|
tags.key | string |
Klucz tagu |
|
value
|
tags.value | string |
Wartość tagu |
|
stringRepresentation
|
tags.stringRepresentation | string |
Reprezentacja ciągu tagu |
|
managementZones
|
managementZones | array of object |
Strefy zarządzania |
|
id
|
managementZones.id | string |
Identyfikator strefy zarządzania |
|
nazwa
|
managementZones.name | string |
Nazwa strefy zarządzania |
|
isInstanceOf
|
fromRelationships.isInstanceOf | array of object |
Jest wystąpieniem |
|
id
|
fromRelationships.isInstanceOf.id | string |
Jest wystąpieniem identyfikatora |
|
typ
|
fromRelationships.isInstanceOf.type | string |
Jest wystąpieniem typu |
|
isDiskOf
|
toRelationships.isDiskOf | array of object |
Jest dyskiem |
|
id
|
toRelationships.isDiskOf.id | string |
Czy dysk o identyfikatorze |
|
typ
|
toRelationships.isDiskOf.type | string |
Czy dysk typu |
Pobieranie wydarzeń
Wyświetla listę zdarzeń w określonym przedziale czasu
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedział czasu
|
from | string |
Początek żądanego przedziału czasu. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Ostrzeżenia
|
warnings | array of string |
Warnings |
|
events
|
events | array of object |
Events |
|
underMaintenance
|
events.underMaintenance | boolean |
W obszarze Konserwacja |
|
suppressAlert
|
events.suppressAlert | boolean |
Pomijanie alertu |
|
suppressProblem
|
events.suppressProblem | boolean |
Problem pomijania |
|
frequentEvent
|
events.frequentEvent | boolean |
Częste zdarzenie |
|
properties
|
events.properties | array of object |
Właściwości |
|
value
|
events.properties.value | string |
Wartość właściwości |
|
klucz
|
events.properties.key | string |
Klucz właściwości |
|
correlationId (identyfikator korelacji)
|
events.correlationId | string |
Identyfikator korelacji |
|
stan
|
events.status | string |
Status |
|
startTime
|
events.startTime | integer |
Godzina rozpoczęcia |
|
endTime
|
events.endTime | integer |
Godzina zakończenia |
|
title
|
events.title | string |
Title |
|
eventType
|
events.eventType | string |
Typ zdarzenia |
|
managementZones
|
events.managementZones | array of object |
Strefy zarządzania |
|
nazwa
|
events.managementZones.name | string |
Nazwa strefy zarządzania |
|
id
|
events.managementZones.id | string |
Identyfikator strefy zarządzania |
|
eventId
|
events.eventId | string |
Identyfikator zdarzenia |
|
entityTags
|
events.entityTags | array of object |
Tagi jednostek |
|
stringRepresentation
|
events.entityTags.stringRepresentation | string |
Reprezentacja ciągu tagu jednostki |
|
value
|
events.entityTags.value | string |
Wartość tagu jednostki |
|
klucz
|
events.entityTags.key | string |
Klucz tagu jednostki |
|
kontekst
|
events.entityTags.context | string |
Kontekst tagu jednostki |
|
id
|
events.entityId.entityId.id | string |
Identyfikator jednostki |
|
typ
|
events.entityId.entityId.type | string |
Typ jednostki |
|
nazwa
|
events.entityId.name | string |
Nazwa encji |
|
nextPageKey
|
nextPageKey | string |
Następny klucz strony |
|
totalCount
|
totalCount | integer |
Łączna liczba |
|
pageSize
|
pageSize | integer |
Rozmiar strony |
Uzyskiwanie komentarza problemu według identyfikatora problemu
Pobiera wszystkie komentarze dotyczące określonego problemu
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator problemu
|
problemId | True | string |
Identyfikator problemu |
Uzyskiwanie komentarza problemu według identyfikatora problemu i identyfikatora komentarza
Pobiera określony komentarz dotyczący problemu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator problemu
|
problemId | True | string |
Identyfikator wymaganego problemu |
|
Identyfikator komentarza
|
commentId | True | string |
Identyfikator wymaganego komentarza |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
id
|
id | string |
Identyfikator komentarza |
|
createdAtTimestamp
|
createdAtTimestamp | integer |
Utworzono znacznik czasu |
|
zawartość
|
content | string |
Zawartość komentarza |
|
authorName
|
authorName | string |
Nazwa autora komentarza |
Uzyskiwanie problemu według identyfikatora
Pobiera właściwości określonego problemu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator problemu
|
problem_id | True | string |
Identyfikator wymaganego problemu |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
details
|
evidenceDetails.details | array of object |
Szczegóły |
|
evidenceType (typ dowodu)
|
evidenceDetails.details.evidenceType | string |
Typ dowodu |
|
nazwa wyświetlana
|
evidenceDetails.details.displayName | string |
Wyświetlana nazwa |
|
id
|
evidenceDetails.details.entity.entityId.id | string |
Identyfikator jednostki dowodu |
|
typ
|
evidenceDetails.details.entity.entityId.type | string |
Typ jednostki dowodu |
|
nazwa
|
evidenceDetails.details.entity.name | string |
Nazwa jednostki dowodu |
|
id
|
evidenceDetails.details.groupingEntity.entityId.id | string |
Grupowanie identyfikatora jednostki |
|
typ
|
evidenceDetails.details.groupingEntity.entityId.type | string |
Grupowanie typu jednostki |
|
nazwa
|
evidenceDetails.details.groupingEntity.name | string |
Nazwa jednostki grupowania |
|
rootCauseRelevant
|
evidenceDetails.details.rootCauseRelevant | boolean |
Istotna główna przyczyna |
|
startTime
|
evidenceDetails.details.startTime | integer |
Data rozpoczęcia danych dowodowych |
|
totalCount
|
evidenceDetails.totalCount | integer |
Łączna liczba szczegółów dowodów |
|
comments
|
recentComments.comments | array of object |
Comments |
|
authorName
|
recentComments.comments.authorName | string |
Nazwa autora ostatnio używanych komentarzy |
|
createdAtTimestamp
|
recentComments.comments.createdAtTimestamp | integer |
Ostatnie komentarze utworzone w znaczniku czasu |
|
kontekst
|
recentComments.comments.context | string |
Kontekst ostatnich komentarzy |
|
id
|
recentComments.comments.id | string |
Ostatnio używany identyfikator komentarzy |
|
zawartość
|
recentComments.comments.content | string |
Ostatnia zawartość komentarzy |
|
pageSize
|
recentComments.pageSize | integer |
Rozmiar strony ostatnio używanych komentarzy |
|
nextPageKey
|
recentComments.nextPageKey | string |
Ostatnie komentarze — następny klucz strony |
|
totalCount
|
recentComments.totalCount | integer |
Łączna liczba ostatnich komentarzy |
|
displayId
|
linkedProblemInfo.displayId | string |
Identyfikator wyświetlania połączonego problemu |
|
identyfikator problemu
|
linkedProblemInfo.problemId | string |
Połączony identyfikator problemu |
|
id
|
rootCauseEntity.entityId.id | string |
Identyfikator jednostki głównej przyczyny |
|
typ
|
rootCauseEntity.entityId.type | string |
Typ jednostki głównej przyczyny |
|
nazwa
|
rootCauseEntity.name | string |
Nazwa jednostki głównej przyczyny |
|
impactedEntities
|
impactedEntities | array of object |
Jednostki, których to dotyczy |
|
id
|
impactedEntities.entityId.id | string |
Identyfikator jednostki, której dotyczy wpływ |
|
typ
|
impactedEntities.entityId.type | string |
Typ jednostki, której dotyczy wpływ |
|
nazwa
|
impactedEntities.name | string |
Nazwa jednostki, której dotyczy wpływ |
|
Wpływ
|
impactAnalysis.impacts | array of object |
Wpływ |
|
impactType
|
impactAnalysis.impacts.impactType | string |
Typ wpływu |
|
id
|
impactAnalysis.impacts.impactedEntity.entityId.id | string |
Identyfikator jednostki, której dotyczy wpływ |
|
typ
|
impactAnalysis.impacts.impactedEntity.entityId.type | string |
Typ jednostki, której dotyczy wpływ |
|
nazwa
|
impactAnalysis.impacts.impactedEntity.name | string |
Nazwa jednostki, której dotyczy wpływ |
|
estimatedAffectedUsers
|
impactAnalysis.impacts.estimatedAffectedUsers | integer |
Szacowani użytkownicy, których dotyczy problem |
|
problemFiltry
|
problemFilters | array of object |
Filtry problemów |
|
nazwa
|
problemFilters.name | string |
Nazwa filtrów problemów |
|
id
|
problemFilters.id | string |
Identyfikator filtrów problemów |
|
impactLevel
|
impactLevel | string |
Poziom wpływu |
|
displayId
|
displayId | string |
Identyfikator wyświetlania |
|
affectedEntities (affectedEntities)
|
affectedEntities | array of object |
Jednostki, których dotyczy problem |
|
id
|
affectedEntities.entityId.id | string |
Identyfikator jednostki, której dotyczy problem |
|
typ
|
affectedEntities.entityId.type | string |
Typ jednostki, której dotyczy problem |
|
nazwa
|
affectedEntities.name | string |
Nazwa jednostki, której dotyczy problem |
|
managementZones
|
managementZones | array of object |
Strefy zarządzania |
|
nazwa
|
managementZones.name | string |
Nazwa strefy zarządzania |
|
id
|
managementZones.id | string |
Identyfikator strefy zarządzania |
|
ważnośćLevel
|
severityLevel | string |
Poziom ważności |
|
entityTags
|
entityTags | array of object |
Tagi jednostek |
|
stringRepresentation
|
entityTags.stringRepresentation | string |
Reprezentacja ciągu tagu jednostki |
|
value
|
entityTags.value | string |
Wartość tagu jednostki |
|
klucz
|
entityTags.key | string |
Klucz tagu jednostki |
|
kontekst
|
entityTags.context | string |
Kontekst tagu jednostki |
|
identyfikator problemu
|
problemId | string |
Identyfikator problemu |
|
stan
|
status | string |
Status |
|
startTime
|
startTime | integer |
Godzina rozpoczęcia |
|
endTime
|
endTime | integer |
Godzina zakończenia |
|
title
|
title | string |
Title |
Uzyskiwanie problemów
Wyświetla listę problemów zaobserwowanych w określonym przedziale czasu.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Przedział czasu
|
from | string |
Zakres zapytania. Przykład: "now-1d" |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Łączna liczba |
|
pageSize
|
pageSize | integer |
Rozmiar strony |
|
nextPageKey
|
nextPageKey | string |
Następny klucz strony |
|
Problemy
|
problems | array of object |
Problemy |
|
affectedEntities (affectedEntities)
|
problems.affectedEntities | array of object |
Jednostki, których dotyczy problem |
|
id
|
problems.affectedEntities.entityId.id | string |
Identyfikator jednostki, której dotyczy problem |
|
typ
|
problems.affectedEntities.entityId.type | string |
Typ jednostki, której dotyczy problem |
|
nazwa
|
problems.affectedEntities.name | string |
Nazwa jednostki, której dotyczy problem |
|
displayId
|
problems.displayId | string |
Identyfikator wyświetlania |
|
impactedEntities
|
problems.impactedEntities | array of object |
Jednostki, których to dotyczy |
|
id
|
problems.impactedEntities.entityId.id | string |
Identyfikator jednostki, której dotyczy wpływ |
|
typ
|
problems.impactedEntities.entityId.type | string |
Typ jednostki, której dotyczy wpływ |
|
nazwa
|
problems.impactedEntities.name | string |
Nazwa jednostki, której dotyczy wpływ |
|
displayId
|
problems.linkedProblemInfo.displayId | string |
Identyfikator wyświetlania połączonego problemu |
|
identyfikator problemu
|
problems.linkedProblemInfo.problemId | string |
Połączony identyfikator problemu |
|
problemFiltry
|
problems.problemFilters | array of object |
Filtry problemów |
|
nazwa
|
problems.problemFilters.name | string |
Nazwa filtru problemu |
|
id
|
problems.problemFilters.id | string |
Identyfikator filtru problemu |
|
totalCount
|
problems.evidenceDetails.totalCount | integer |
Łączna liczba |
|
details
|
problems.evidenceDetails.details | array of object |
Szczegóły |
|
evidenceType (typ dowodu)
|
problems.evidenceDetails.details.evidenceType | string |
Typ dowodu |
|
nazwa wyświetlana
|
problems.evidenceDetails.details.displayName | string |
Wyświetlana nazwa |
|
id
|
problems.evidenceDetails.details.entity.entityId.id | string |
Identyfikator jednostki szczegółów dowodów |
|
typ
|
problems.evidenceDetails.details.entity.entityId.type | string |
Typ jednostki Szczegóły dowodów |
|
nazwa
|
problems.evidenceDetails.details.entity.name | string |
Nazwa jednostki szczegółów dowodów |
|
id
|
problems.evidenceDetails.details.groupingEntity.entityId.id | string |
Grupowanie identyfikatora jednostki |
|
typ
|
problems.evidenceDetails.details.groupingEntity.entityId.type | string |
Grupowanie typu jednostki |
|
nazwa
|
problems.evidenceDetails.details.groupingEntity.name | string |
Nazwa jednostki grupowania |
|
rootCauseRelevant
|
problems.evidenceDetails.details.rootCauseRelevant | boolean |
Istotna główna przyczyna |
|
startTime
|
problems.evidenceDetails.details.startTime | integer |
Data rozpoczęcia dowodu |
|
comments
|
problems.recentComments.comments | array of object |
Comments |
|
createdAtTimestamp
|
problems.recentComments.comments.createdAtTimestamp | integer |
Komentarz utworzony w znaczniku czasu |
|
authorName
|
problems.recentComments.comments.authorName | string |
Nazwa autora komentarza |
|
kontekst
|
problems.recentComments.comments.context | string |
Kontekst komentarza |
|
id
|
problems.recentComments.comments.id | string |
Identyfikator komentarza |
|
zawartość
|
problems.recentComments.comments.content | string |
Zawartość komentarza |
|
pageSize
|
problems.recentComments.pageSize | integer |
PageSize |
|
nextPageKey
|
problems.recentComments.nextPageKey | string |
Następny klucz strony |
|
totalCount
|
problems.recentComments.totalCount | integer |
Łączna liczba |
|
Wpływ
|
problems.impactAnalysis.impacts | array of object |
Wpływ |
|
impactType
|
problems.impactAnalysis.impacts.impactType | string |
Typ wpływu |
|
id
|
problems.impactAnalysis.impacts.impactedEntity.entityId.id | string |
Identyfikator jednostki, której dotyczy wpływ |
|
typ
|
problems.impactAnalysis.impacts.impactedEntity.entityId.type | string |
Typ jednostki, której dotyczy wpływ |
|
nazwa
|
problems.impactAnalysis.impacts.impactedEntity.name | string |
Nazwa jednostki, której dotyczy wpływ |
|
estimatedAffectedUsers
|
problems.impactAnalysis.impacts.estimatedAffectedUsers | integer |
Szacowani użytkownicy, których dotyczy problem |
|
id
|
problems.rootCauseEntity.entityId.id | string |
Identyfikator jednostki głównej przyczyny |
|
typ
|
problems.rootCauseEntity.entityId.type | string |
Typ głównej przyczyny |
|
nazwa
|
problems.rootCauseEntity.name | string |
Nazwa jednostki głównej przyczyny |
|
managementZones
|
problems.managementZones | array of object |
Strefy zarządzania |
|
nazwa
|
problems.managementZones.name | string |
Nazwa strefy zarządzania |
|
id
|
problems.managementZones.id | string |
Identyfikator strefy zarządzania |
|
ważnośćLevel
|
problems.severityLevel | string |
Poziom ważności |
|
entityTags
|
problems.entityTags | array of object |
Tagi jednostek |
|
stringRepresentation
|
problems.entityTags.stringRepresentation | string |
Reprezentacja ciągu tagu jednostki |
|
value
|
problems.entityTags.value | string |
Wartość tagu jednostki |
|
klucz
|
problems.entityTags.key | string |
Klucz tagu jednostki |
|
kontekst
|
problems.entityTags.context | string |
Kontekst tagu jednostki |
|
identyfikator problemu
|
problems.problemId | string |
Identyfikator problemu |
|
impactLevel
|
problems.impactLevel | string |
Poziom wpływu |
|
stan
|
problems.status | string |
Status |
|
startTime
|
problems.startTime | integer |
Godzina rozpoczęcia |
|
endTime
|
problems.endTime | integer |
Godzina zakończenia |
|
title
|
problems.title | string |
Title |
|
Ostrzeżenia
|
warnings | array of string |
Warnings |
Uzyskiwanie problemów z zabezpieczeniami
Wyświetla listę wszystkich problemów z zabezpieczeniami
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Selektor problemu z zabezpieczeniami
|
securityProblemSelector | string |
Definiuje zakres zapytania. Odpowiedzi dotyczą tylko problemów z zabezpieczeniami spełniających określone kryteria |
|
|
Przedział czasu
|
from | string |
Początek żądanego przedziału czasu |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
totalCount
|
totalCount | integer |
Łączna liczba |
|
pageSize
|
pageSize | integer |
Rozmiar strony |
|
nextPageKey
|
nextPageKey | string |
Następny klucz strony |
|
securityProblems
|
securityProblems | array of object |
Problemy z zabezpieczeniami |
|
securityProblemId
|
securityProblems.securityProblemId | string |
Identyfikator problemu z zabezpieczeniami |
|
displayId
|
securityProblems.displayId | string |
Identyfikator wyświetlania |
|
stan
|
securityProblems.status | string |
Status |
|
Wyciszony
|
securityProblems.muted | boolean |
Wyciszony |
|
externalVulnerabilityId
|
securityProblems.externalVulnerabilityId | string |
Identyfikator zewnętrznej luki w zabezpieczeniach |
|
vulnerabilityType
|
securityProblems.vulnerabilityType | string |
Typ luki w zabezpieczeniach |
|
title
|
securityProblems.title | string |
Title |
|
packageName
|
securityProblems.packageName | string |
Nazwa pakietu |
|
URL
|
securityProblems.url | string |
adres URL |
|
Technologia
|
securityProblems.technology | string |
Technologia |
|
firstSeenTimestamp
|
securityProblems.firstSeenTimestamp | integer |
Pierwszy widziany znacznik czasu |
|
lastUpdatedTimestamp
|
securityProblems.lastUpdatedTimestamp | integer |
Znacznik czasu ostatniej aktualizacji |
|
riskLevel
|
securityProblems.riskAssessment.riskLevel | string |
Poziom ryzyka |
|
riskScore
|
securityProblems.riskAssessment.riskScore | integer |
Ocena ryzyka |
|
riskVector
|
securityProblems.riskAssessment.riskVector | string |
Wektor ryzyka |
|
baseRiskLevel
|
securityProblems.riskAssessment.baseRiskLevel | string |
Podstawowy poziom ryzyka |
|
baseRiskScore
|
securityProblems.riskAssessment.baseRiskScore | integer |
Podstawowy wynik ryzyka |
|
baseRiskVector
|
securityProblems.riskAssessment.baseRiskVector | string |
Podstawowy wektor ryzyka |
|
ekspozycja
|
securityProblems.riskAssessment.exposure | string |
Narażenie |
|
zasoby danych
|
securityProblems.riskAssessment.dataAssets | string |
Zasoby danych |
|
publicExploit
|
securityProblems.riskAssessment.publicExploit | string |
Wykorzystanie publiczne |
|
vulnerableFunctionUsage
|
securityProblems.riskAssessment.vulnerableFunctionUsage | string |
Użycie funkcji podatnych na zagrożenia |
|
managementZones
|
securityProblems.managementZones | array of object |
Strefy zarządzania |
|
nazwa
|
securityProblems.managementZones.name | string |
Nazwa strefy zarządzania |
|
id
|
securityProblems.managementZones.id | string |
Identyfikator strefy zarządzania |
|
cveIds
|
securityProblems.cveIds | array of string |
Identyfikatory CVE |
Uzyskiwanie problemów z zabezpieczeniami według identyfikatora
Pobieranie parametrów problemów z zabezpieczeniami
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Identyfikator problemu secuirty
|
id | True | string |
Identyfikator określonego problemu z zabezpieczeniami |
|
Pola formularza
|
fields | string |
Lista dodatkowych właściwości problemów z zabezpieczeniami, które można dodać do odpowiedzi. Aby dodać właściwości, określ je na rozdzielanej przecinkami liście i prefiksie każdej właściwości z wartością plus (na przykład +riskAssessment,+managementZoness). |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
securityProblemId
|
securityProblemId | string |
Identyfikator problemu z zabezpieczeniami |
|
displayId
|
displayId | string |
Identyfikator wyświetlania |
|
stan
|
status | string |
Status |
|
Wyciszony
|
muted | boolean |
Wyciszony |
|
externalVulnerabilityId
|
externalVulnerabilityId | string |
Identyfikator zewnętrznej luki w zabezpieczeniach |
|
vulnerabilityType
|
vulnerabilityType | string |
Typ luki w zabezpieczeniach |
|
title
|
title | string |
Title |
|
packageName
|
packageName | string |
Nazwa pakietu |
|
URL
|
url | string |
adres URL |
|
opis
|
description | string |
Description |
|
Technologia
|
technology | string |
Technologia |
|
firstSeenTimestamp
|
firstSeenTimestamp | integer |
Pierwszy widziany znacznik czasu |
|
lastUpdatedTimestamp
|
lastUpdatedTimestamp | integer |
Znacznik czasu ostatniej aktualizacji |
|
riskLevel
|
riskAssessment.riskLevel | string |
Poziom ryzyka |
|
|
riskAssessment.riskScore | float |
Ocena ryzyka |
|
riskVector
|
riskAssessment.riskVector | string |
Wektor ryzyka |
|
baseRiskLevel
|
riskAssessment.baseRiskLevel | string |
Podstawowy poziom ryzyka |
|
|
riskAssessment.baseRiskScore | float |
Podstawowy wynik ryzyka |
|
baseRiskVector
|
riskAssessment.baseRiskVector | string |
Podstawowy wektor ryzyka |
|
ekspozycja
|
riskAssessment.exposure | string |
Narażenie |
|
zasoby danych
|
riskAssessment.dataAssets | string |
Zasoby danych |
|
publicExploit
|
riskAssessment.publicExploit | string |
Wykorzystanie publiczne |
|
vulnerableFunctionUsage
|
riskAssessment.vulnerableFunctionUsage | string |
Użycie funkcji podatnych na zagrożenia |
|
managementZones
|
managementZones | array of object |
Strefy zarządzania |
|
nazwa
|
managementZones.name | string |
Nazwa strefy zarządzania |
|
id
|
managementZones.id | string |
Identyfikator strefy zarządzania |
|
cveIds
|
cveIds | array of string |
Identyfikatory CVE |
|
events
|
events | array of object |
Events |
|
sygnatura czasowa
|
events.timestamp | integer |
Sygnatura czasowa zdarzenia |
|
powód
|
events.reason | string |
Przyczyna zdarzenia |
|
numberOfAffectedEntities
|
events.riskAssessmentSnapshot.numberOfAffectedEntities | integer |
Liczba jednostek, których dotyczy problem |
|
numberOfReachableDataAssets
|
events.riskAssessmentSnapshot.numberOfReachableDataAssets | integer |
Liczba dostępnych zasobów danych |
|
publicExploit
|
events.riskAssessmentSnapshot.publicExploit | string |
Wykorzystanie publiczne |
|
ekspozycja
|
events.riskAssessmentSnapshot.exposure | string |
Narażenie |
|
vulnerableFunctionUsage
|
events.riskAssessmentSnapshot.vulnerableFunctionUsage | string |
Użycie funkcji podatnych na zagrożenia |
|
użytkownik
|
events.muteState.user | string |
Użytkownik stanu wyciszenia |
|
powód
|
events.muteState.reason | string |
Przyczyna stanu wyciszenia |
|
komentarz
|
events.muteState.comment | string |
Wycisz komentarz stanu |
|
vulnerableComponents
|
vulnerableComponents | array of object |
Składniki podatne na zagrożenia |
|
id
|
vulnerableComponents.id | string |
Identyfikator składników podatnych na zagrożenia |
|
nazwa wyświetlana
|
vulnerableComponents.displayName | string |
Nazwa wyświetlana aplikacji Componenets podatnych na zagrożenia |
|
fileName
|
vulnerableComponents.fileName | string |
Nazwa pliku składników podatnych na zagrożenia |
|
numberOfAffectedEntities
|
vulnerableComponents.numberOfAffectedEntities | integer |
Liczba jednostek, których dotyczy problem, składników podatnych na zagrożenia |
|
affectedEntities (affectedEntities)
|
vulnerableComponents.affectedEntities | array of string |
Jednostki, których dotyczy problem |
|
affectedEntities (affectedEntities)
|
affectedEntities | array of string |
Jednostki, których dotyczy problem |
|
exposedEntities
|
exposedEntities | array of string |
Uwidocznione jednostki |
|
reachableDataAssets
|
reachableDataAssets | array of string |
Dostępne zasoby danych |
|
applications
|
relatedEntities.applications | array of object |
Aplikacje |
|
id
|
relatedEntities.applications.id | string |
Identyfikator aplikacji |
|
numberOfAffectedEntities
|
relatedEntities.applications.numberOfAffectedEntities | integer |
Liczba jednostek, których dotyczy problem |
|
affectedEntities (affectedEntities)
|
relatedEntities.applications.affectedEntities | array of string |
Jednostki, których dotyczy problem aplikacji |
|
services
|
relatedEntities.services | array of object |
Services |
|
id
|
relatedEntities.services.id | string |
Identyfikator usługi |
|
numberOfAffectedEntities
|
relatedEntities.services.numberOfAffectedEntities | integer |
Liczba jednostek, których dotyczy problem, |
|
affectedEntities (affectedEntities)
|
relatedEntities.services.affectedEntities | array of string |
Jednostki, których dotyczy problem z usługą |
|
ekspozycja
|
relatedEntities.services.exposure | string |
Narażenie |
|
hosts
|
relatedEntities.hosts | array of object |
Hosts |
|
id
|
relatedEntities.hosts.id | string |
Identyfikator hosta |
|
numberOfAffectedEntities
|
relatedEntities.hosts.numberOfAffectedEntities | integer |
Liczba jednostek, których dotyczy problem |
|
affectedEntities (affectedEntities)
|
relatedEntities.hosts.affectedEntities | array of string |
Jednostki, których dotyczy problem z hostem |
|
Baz danych
|
relatedEntities.databases | array of string |
Databases |
|
kubernetesWorkloads
|
relatedEntities.kubernetesWorkloads | array of object |
Obciążenia kubernetes |
|
id
|
relatedEntities.kubernetesWorkloads.id | string |
Identyfikator obciążenia platformy Kubernetes |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesWorkloads.numberOfAffectedEntities | integer |
Liczba jednostek, których dotyczy obciążenie platformy Kubernetes |
|
affectedEntities (affectedEntities)
|
relatedEntities.kubernetesWorkloads.affectedEntities | array of string |
Jednostki, których dotyczy obciążenie kubernetes |
|
kubernetesClusters
|
relatedEntities.kubernetesClusters | array of object |
Klastry Kubernetes |
|
id
|
relatedEntities.kubernetesClusters.id | string |
Identyfikator klastra Kubernetes |
|
numberOfAffectedEntities
|
relatedEntities.kubernetesClusters.numberOfAffectedEntities | integer |
Liczba jednostek, których dotyczy problem, na platformie Kubernetes |
|
affectedEntities (affectedEntities)
|
relatedEntities.kubernetesClusters.affectedEntities | array of string |
Jednostki, których dotyczy klaster Kubernetes |
|
containerImages
|
relatedContainerImages.containerImages | array of object |
Obrazy kontenerów |
|
imageId
|
relatedContainerImages.containerImages.imageId | string |
Identyfikator obrazu powiązanego kontenera |
|
imageName (nazwa_obrazu)
|
relatedContainerImages.containerImages.imageName | string |
Nazwa obrazu powiązanego kontenera |
|
numberOfAffectedEntities
|
relatedContainerImages.containerImages.numberOfAffectedEntities | integer |
Powiązana liczba jednostek, których dotyczy problem |
|
affectedEntities (affectedEntities)
|
relatedContainerImages.containerImages.affectedEntities | array of string |
Powiązane jednostki kontenera, których dotyczy problem |
|
muteStateChangeInProgress
|
muteStateChangeInProgress | boolean |
Zmiana stanu wyciszenia w toku |