Comprender el resumen de la tecnología API
Establecimiento de la configuración de API de EC
Utilización de llamadas y herramientas de API de OData
Optimización de las funciones de la API de EC OData
Realizando operación de escritura de EC OData
Gestión del Centro de integración
Configuración de la notificación de evento externo
API de supervisión
Analizando apéndice

Comprender la supervisión de API

Objective

After completing this lesson, you will be able to explore conceptos fundamentales de monitoreo de API para mejorar el rendimiento en múltiples plataformas.

Introducción

La siguiente serie de contenidos cubrirá el conocimiento básico de las API de supervisión en diferentes plataformas.

Log de API OData y SOAP

Antes de que desee supervisar los logs de API OData/SOAP, debe asegurarse de que ya ha activado los permisos para ellos.

Opciones de permisos para logs de API OData/SOAP.

Resumen

Aprenderá los detalles del log de API de las siguientes diapositivas. Para ver la información de payload, en la tabla de log, seleccione el botón situado debajo de las columnas "HTTP" o "REST". Verá el payload HTTP o los detalles de payload REST. La columna ID de solicitud en la tabla de log se puede utilizar para registrar y visualizar el ID de solicitud para cada llamada API OData registrada. Puede utilizar ID de solicitud como criterios de búsqueda cuando sea necesario.

SAP SFAPI Audit Log muestra detalles de inicio de sesión, tiempos de llamada, minutos de respuesta, ID de sesión e ID de correlación, con opciones de filtro.

Solicitud

Esta es la solicitud de logs de audio de la API de OData, puede verificar los detalles de la solicitud, siempre es fácil encontrar la cláusula Select en el detalle de la solicitud.

Ventana Detalles SOAP que muestra el código XML para una consulta en Detalles de registro de auditoría de SFAPI.

Respuesta

El correspondiente es el detalle de la respuesta, también puede verificar los detalles de la respuesta para obtener fácilmente la información valiosa.

Ventana de respuesta detallada de SOAP con datos XML que incluye información de usuario como país, fecha de creación y detalles de inicio de sesión.

Log de respuestas

A veces hay algún error o información de advertencia en la cola de la respuesta, puede conocer la excepción a través de estos mensajes.

Detalles de SAP Audit Log que muestran un mensaje de advertencia sobre un campo cost_center que falta en los datos de respuesta XML.

Cabecera de API SOAP

Cabeceras de solicitud HTTP en los detalles de SAP Audit Log que muestran la dirección IP y la información de conexión.

Log de depuración de auditoría en Provisioning

También podemos supervisar el proceso y el servicio a través del log de depuración de auditoría en Provisioning.Aquí debe introducir el ID de sesión para obtener las excepciones causadas por las llamadas de API del log del servidor (misma información disponible en splunk)

Página de log de depuración de SAP que muestra la lista de entradas de log con ID, marcas de tiempo y detalles de sesión.

Controlar trabajos

La captura de pantalla nos ofrece otra forma de supervisar las API supervisando las tareas en el aprovisionamiento. Para este monitor puede obtener/descargar el estado del trabajo (importación/exportación/sincronización) en Provisioning.

La página Supervisar jobs muestra los tipos de job, los estados, los tiempos de envío y los enlaces de estado de descarga para cada entrada de job

Supervisar procesamiento de mensajes

El monitor de mensajes proporciona un resumen de los mensajes procesados en un arrendatario y le permite visualizar los detalles de mensajes individuales. Abra el monitor de mensajes con las siguientes acciones: Haga clic en un mosaico en el área Supervisar procesamiento de mensajes. Los mensajes se visualizan de acuerdo con las opciones de filtro del mosaico; puede controlar qué mensajes se visualizan modificando el filtro.

Opciones de filtro

  • Puede controlar qué mensajes se visualizan modificando el filtro.
  • Puede filtrar mensajes por Estado, Hora, Artefacto o por ID.
Integración de SAP HANA Cloud que muestra los logs de procesamiento de mensajes fallidos para la confirmación de SAP ERP a Employee Central.

Gestionar contenido de integración

La sección Gestionar contenido de integración proporciona un resumen de los artefactos de contenido de integración, como los flujos de integración, que se han desplegado en el arrendatario. Se visualizan artefactos con el estado y el tipo correspondientes (del mosaico). Puede adaptar el conjunto de artefactos visualizados modificando el filtro. Al hacer clic en el Estado de un artefacto, los detalles del artefacto se visualizan en modo de página completa y se visualizan los siguientes detalles adicionales (como el tiempo de procesamiento y el nombre del flujo de integración).

Resumen del contenido de integración

Como resultado de las opciones de filtro, se visualiza una lista de artefactos de integración en una tabla con los siguientes atributos:

  • Estado
  • Tipo
  • Artefacto
Interfaz de SAP HANA Cloud Integration que muestra el estado del contenido de integración para Upsert de OData genérico de SAP ERP a Employee Central.

Resumen de material de seguridad

El área Gestionar material de seguridad proporciona un resumen de los artefactos relacionados con la seguridad.

Para crear/desplegar un artefacto nuevo, seleccione Añadir y seleccione el tipo de artefacto (posible para los siguientes tipos de artefacto: Credencial y Hosts conocidos (SSH)).

Para editar y volver a desplegar un artefacto existente, seleccione el artefacto en la tabla y elija Editar (solo se admite para artefactos editables).

Para descargar un artefacto, seleccione el artefacto en la tabla y elija Descargar (no disponible para Credenciales).

También puede eliminar un artefacto (compatible con todos los tipos de artefactos excepto Keystore).

Se visualiza una lista de material de seguridad en una tabla. Para cada artefacto, se visualizan los siguientes atributos:

  • Tipo
  • Estado
  • Desplegado por
  • Desplegado el
SAP HANA Cloud Integration muestra una lista de materiales de seguridad con nombres, tipos, estados y detalles de implementación.

Códigos de respuesta HTTP

Tipos de error elegibles para reintentoNotas adicionales
Código de respuesta HTTP 5XX (distinto de 500)

Un error 500 no se recuperará porque se debe a un problema con su consulta o payload.

Nota 503 El servicio no disponible puede ocurrir cuando un servidor está sobrecargado, pero también puede ocurrir durante los períodos de mantenimiento.

  • Debe evitar la ejecución durante períodos de mantenimiento especificados.

Código de respuesta HTTP 412

Para las operaciones de edición pueden producirse durante el bloqueo optimista en las transacciones de back end.

Esto incluye una transacción específica en un $batch e instancias específicas en un payload Upsert de varios registros.

  • Para las operaciones por lotes, reintente solo los registros fallidos.
  • No incluya operaciones de edición correctas en el payload de reintento.
  • Para 412 errores, reintente solo un máximo de 1 vez.
Errores de tiempo de espera HTTPSe puede volver a intentar, pero solo si el tiempo de espera del cliente coincide con el tiempo de espera de la infraestructura de SuccessFactors de 5 minutos. Si vuelve a intentar un tiempo de espera antes de este período, apilará las transacciones entre sí y realizará un posible ataque de denegación de servicio.
Se ha restablecido la conexión HTTP y no hay respuesta del lado del servidor 
Sesión no válidaEsto puede ocurrir cuando un servidor falla y el equilibrador de carga mueve solicitudes a un nuevo servidor.
Código de respuesta HTTP 401No vuelva a intentar errores de autenticación 401; sus credenciales tampoco se aceptarán en el segundo intento.
Código de respuesta HTTP 404No se encontró el recurso ya que no habrá posibilidad de recuperación si está consultando algo que no existe.
Código de respuesta HTTP 400 (problemas de datos)Esto puede ocurrir para operaciones de edición en las que faltan datos necesarios o que tienen formatos incorrectos.
 No vuelva a intentar las operaciones Create/POST ni Upsert en las que el objeto tenga una clave de incremento automático. Ambos pueden dar lugar a datos duplicados.

Supervisar API

Resumen del proceso

Esta simulación muestra los pasos de configuración básicos necesarios para configurar manualmente la configuración para SAP SuccessFactors Employee Central. Obtendrá los conocimientos básicos de la llamada y las herramientas de la API de OData. Cómo supervisar las API para diferentes socios.

Prerrequisitos

La siguiente configuración y personalización deben haberse completado antes de implementar la configuración básica en SAP SuccessFactors.

  • Acceso a SFAPI de OData
  • Acceso al log de audio
  • Acceso a herramientas de API

Resultado

Como parte de esta demostración, cubriremos la sección de configuración en EC, que es: API de supervisión.