GET сервис: различия между версиями

Материал из Dynatrace
(Новая страница: «Получает параметры указанной службы. Запрос создает <code>application/json</code>полезную нагрузку....»)
 
 
Строка 24: Строка 24:
|meIdentifier
|meIdentifier
|string
|string
|Идентификатор объекта Ключ-АСТРОМ требуемой службы.
|Идентификатор объекта Dynatrace требуемой службы.
|дорожка
|дорожка
|требуется
|требуется
Строка 52: Строка 52:
|entityId
|entityId
|string
|string
|Идентификатор объекта Ключ-АСТРОМ требуемого объекта.
|Идентификатор объекта Dynatrace требуемого объекта.
|-
|-
|displayName
|displayName
|string
|string
|Имя объекта Ключ-АСТРОМ, отображаемое в пользовательском интерфейсе.
|Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе.
|-
|-
|customizedName
|customizedName
Строка 241: Строка 241:


==== Объект <code>TagInfo</code> ====
==== Объект <code>TagInfo</code> ====
Тег сущности Ключ-АСТРОМ.
Тег сущности Dynatrace.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 278: Строка 278:


==== Объект <code>EntityShortRepresentation</code> ====
==== Объект <code>EntityShortRepresentation</code> ====
Краткое представление объекта Ключ-АСТРОМ.
Краткое представление объекта Dynatrace.
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 286: Строка 286:
|id
|id
|string
|string
|Идентификатор объекта Ключ-АСТРОМ.
|Идентификатор объекта Dynatrace.
|-
|-
|name
|name
|string
|string
|Имя объекта Ключ-АСТРОМ.
|Имя объекта Dynatrace.
|-
|-
|description
|description
|string
|string
|Краткое описание сущности Ключ-АСТРОМ.
|Краткое описание сущности Dynatrace.
|}
|}


==== Объект _ <code>TechnologyInfo</code> ====
==== Объект <code>TechnologyInfo</code> ====
{| class="wikitable"
{| class="wikitable"
!Элемент
!Элемент
Строка 364: Строка 364:
     {
     {
       "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
       "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
       "name": "Astromkey entity",
       "name": "Dynatrace entity",
       "description": "Astromkey entity for the REST API example"
       "description": "Dynatrace entity for the REST API example"
     }
     }
   ],
   ],
Строка 399: Строка 399:
==== Curl ====
==== Curl ====
  <code>curl -X GET \
  <code>curl -X GET \
   '<nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/entity/services/SERVICE-72503CBDD2AEF066'</nowiki> \
   '<nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066'</nowiki> \
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \</code>
   -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \</code>


==== URL-адрес запроса ====
==== URL-адрес запроса ====
  <code><nowiki>https://mySampleEnv.live.ruscomtech.ru/api/v1/entity/services/SERVICE-72503CBDD2AEF066</nowiki></code>
  <code><nowiki>https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066</nowiki></code>


==== Тело ответа ====
==== Тело ответа ====

Текущая версия на 14:30, 3 февраля 2023

Получает параметры указанной службы.

Запрос создает application/jsonполезную нагрузку.

GET Managed https://{your-domain}/e/{your-environment-id}/api/v1/entity/services/{meIdentifier}
Среда АктивногоШлюза https://{your-activegate-domain}/e/{your-environment-id}/api/v1/entity/services/{meIdentifier}

Аутентификация

Чтобы выполнить этот запрос, вам нужен токен доступа с проблемой доступа и каналом событий, метриками и областью топологии ( DataExport) . Чтобы узнать, как его получить и использовать, см. раздел Токены и аутентификация .

Параметры

Параметр Тип Описание В Необходимый
meIdentifier string Идентификатор объекта Dynatrace требуемой службы. дорожка требуется

Ответ

Коды ответов

Код Тип Описание
200 Service Успех

Объекты тела ответа

Объект Service

Элемент Тип Описание
entityId string Идентификатор объекта Dynatrace требуемого объекта.
displayName string Имя объекта Dynatrace, отображаемое в пользовательском интерфейсе.
customizedName string Пользовательское имя объекта
discoveredName string Обнаруженное имя объекта
firstSeenTimestamp integer Отметка времени первого обнаружения объекта в миллисекундах UTC.
lastSeenTimestamp integer Отметка времени последнего обнаружения объекта в миллисекундах UTC.
tags TagInfo[] Список тегов сущностей.
fromRelationships объект -
toRelationships объект -
path string -
webServerName string -
ibmCtgServerName string Имя шлюза транзакций IBM CICS.
akkaActorSystem string Услуги системы akka actor.
contextRoot string -
port integer -
ibmCtgGatewayUrl string URL-адрес шлюза IBM CTG.
databaseName string -
ipAddresses string [] -
webServiceName string -
className string -
webApplicationId string -
managementZones EntityShortRepresentation[] Зоны управления, частью которых является объект.
agentTechnologyType string -

Элемент может содержать эти значения

  • APACHE
  • DOTNET
  • DUMPPROC
  • GO
  • IIS
  • JAVA
  • LOG_ANALYTICS
  • N/A
  • NET
  • NETTRACER
  • NGINX
  • NODEJS
  • OPENTRACINGNATIVE
  • OS
  • PHP
  • PLUGIN
  • PROCESS
  • PYTHON
  • REMOTE_PLUGIN
  • RUBY
  • SDK
  • UPDATER
  • VARNISH
  • WSMB
  • Z
remoteEndpoint string Конечная точка удаленной службы.
softwareTechnologies TechnologyInfo[] -
webServiceNamespace string -
remoteServiceName string Имя удаленной службы.
serviceTechnologyTypes string [] -
databaseHostNames string [] -
esbApplicationName string Имя приложения ESB.
serviceType string -

Элемент может содержать эти значения

  • AMP
  • Cics
  • CicsInteraction
  • CustomApplication
  • Database
  • EnterpriseServiceBus
  • External
  • Ims
  • ImsInteraction
  • Messaging
  • Method
  • Mobile
  • Process
  • QueueInteraction
  • QueueListener
  • RemoteCall
  • Rmi
  • SaasVendor
  • Span
  • Unknown
  • WebRequest
  • WebService
  • WebSite
  • ZosConnect
iibApplicationName string Имя приложения IIB.
isExternalService логический -
databaseVendor string -

Объект TagInfo

Тег сущности Dynatrace.

Элемент Тип Описание
context string Происхождение тега, например AWS или Cloud Foundry.

Пользовательские теги используют это CONTEXTLESSзначение.

Элемент может содержать эти значения

  • AWS
  • AWS_GENERIC
  • AZURE
  • CLOUD_FOUNDRY
  • CONTEXTLESS
  • ENVIRONMENT
  • GOOGLE_CLOUD
  • KUBERNETES
key string Ключ тега.

Пользовательские теги имеют значение тега здесь.

value string Значение тега.

Не применимо к пользовательским тегам.

Объект EntityShortRepresentation

Краткое представление объекта Dynatrace.

Элемент Тип Описание
id string Идентификатор объекта Dynatrace.
name string Имя объекта Dynatrace.
description string Краткое описание сущности Dynatrace.

Объект TechnologyInfo

Элемент Тип Описание
type string -
edition string -
version string -

JSON-модель тела ответа

{
  "entityId": "string",
  "displayName": "string",
  "customizedName": "string",
  "discoveredName": "string",
  "firstSeenTimestamp": 1,
  "lastSeenTimestamp": 1,
  "tags": [
    {
      "context": "AWS",
      "key": "string",
      "value": "string"
    }
  ],
  "fromRelationships": {
    "runsOnProcessGroupInstance": [
      "string"
    ],
    "calls": [
      "string"
    ],
    "runsOn": [
      "string"
    ]
  },
  "toRelationships": {
    "calls": [
      "string"
    ]
  },
  "path": "string",
  "webServerName": "string",
  "ibmCtgServerName": "string",
  "akkaActorSystem": "string",
  "contextRoot": "string",
  "port": 1,
  "ibmCtgGatewayUrl": "string",
  "databaseName": "string",
  "ipAddresses": [
    "string"
  ],
  "webServiceName": "string",
  "className": "string",
  "webApplicationId": "string",
  "managementZones": [
    {
      "id": "6a98d7bc-abb9-44f8-ae6a-73e68e71812a",
      "name": "Dynatrace entity",
      "description": "Dynatrace entity for the REST API example"
    }
  ],
  "agentTechnologyType": "APACHE",
  "remoteEndpoint": "string",
  "softwareTechnologies": [
    {
      "type": "string",
      "edition": "string",
      "version": "string"
    }
  ],
  "webServiceNamespace": "string",
  "remoteServiceName": "string",
  "serviceTechnologyTypes": [
    "string"
  ],
  "databaseHostNames": [
    "string"
  ],
  "esbApplicationName": "string",
  "serviceType": "AMP",
  "iibApplicationName": "string",
  "isExternalService": true,
  "databaseVendor": "string"
}

Пример

В этом примере запрос получает сведения о PHP-FPM через сервис доменного сокета /run/php7-fpm.sock с идентификатором SERVICE-72503CBDD2AEF066 .

Маркер API передается в заголовке авторизации .

Curl

curl -X GET \
  'https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066' \
  -H 'Authorization: Api-Token dt0c01.abc123.abcdefjhij1234567890' \

URL-адрес запроса

https://mySampleEnv.live.dynatrace.com/api/v1/entity/services/SERVICE-72503CBDD2AEF066

Тело ответа

{
  "entityId": "SERVICE-72503CBDD2AEF066",
  "displayName": "PHP-FPM via domain socket /run/php7-fpm.sock",
  "discoveredName": "PHP-FPM via domain socket /run/php7-fpm.sock",
  "firstSeenTimestamp": 1505902015554,
  "lastSeenTimestamp": 1546010106998,
  "tags": [],
  "fromRelationships": {
    "runsOnProcessGroupInstance": [
      "PROCESS_GROUP_INSTANCE-9BA70456D770536E",
      "PROCESS_GROUP_INSTANCE-7E988C3503AE8803"
    ],
    "runsOn": [
      "PROCESS_GROUP-E5C3CC7EC1F80B5B"
    ]
  },
  "toRelationships": {
    "calls": [
      "SERVICE-5304CCF4AFBFF35E"
    ]
  },
  "agentTechnologyType": "N/A",
  "serviceType": "WebRequest",
  "softwareTechnologies": [
    {
      "type": "SQLITE",
      "edition": null,
      "version": null
    },
    {
      "type": "PHP",
      "edition": "FPM",
      "version": "7.0.32"
    },
    {
      "type": "PHP_FPM",
      "edition": null,
      "version": null
    }
  ]
}

Код ответа

200

Источник — https://doc.expert-apm.kz/index.php?title=GET_сервис&oldid=2968