[comment]: # translation:outdated [comment]: # ({d1387fc4-f9178426}) # sla.getsli [comment]: # ({/d1387fc4-f9178426}) [comment]: # ({3fde2eb3-531f7cc6}) ### Descripción `object sla.getsli(object parameters)` Este método permite calcular los datos del Indicador de Nivel de Servicio (SLI) para un Acuerdo de Nivel de Servicio (SLA). ::: noteclassic Este método está disponible para usuarios de cualquier tipo. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Ver [Roles de usuario](/manual/web_interface/frontend_sections/users/user_roles) para obtener más información. ::: [comment]: # ({/3fde2eb3-531f7cc6}) [comment]: # ({270c9b0a-bcbf1cf2}) ### Parámetros `(objeto)` Parámetros que contienen el ID del SLA, períodos de informe y, opcionalmente, los ID de los servicios - para calcular el SLI. |Parámetro|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |slaid|ID|ID del SLA para el cual devolver información de disponibilidad.

[Comportamiento del parámetro](/manual/api/reference_commentary#parameter-behavior):
- *obligatorio*| |period\_from|marca de tiempo|Fecha de inicio (inclusive) para informar el SLI.

Valores posibles: marca de tiempo.| |period\_to|marca de tiempo|Fecha de finalización (exclusiva) para informar el SLI.

Valores posibles: marca de tiempo.| |periods|array|Número preferido de períodos para informar.

Valores posibles: 1-100| |serviceids|ID/matriz|ID de servicios para los que devolver el SLI.| [comment]: # ({/270c9b0a-bcbf1cf2}) [comment]: # ({9478a80d-31bc72e4}) #### Partición de períodos La siguiente tabla muestra la disposición de los sectores del período devuelto en función de combinaciones de parámetros. ::: noteclassic Los períodos devueltos no precederán al primer período disponible según la fecha de vigencia del SLA y no excederán el período actual. ::: |Parámetros| | |Descripción| |--|--|--|----| |**período\_desde**|**período\_hasta**|**períodos**| | |-|-|-|Devuelve los últimos 20 periodos.| |-|-|especificado|Devuelve los últimos períodos especificados por el parámetro **periodos**.| |-|especificado|-|Devuelve los últimos 20 períodos antes de la fecha **period\_to** especificada.| |-|especificado|especificado|Devuelve los últimos períodos especificados por el parámetro **periods** antes de la fecha **period\_to** especificada.| |especificado|-|-|Devuelve los primeros 20 períodos que comienzan con la fecha especificada **period\_from**.| |especificado|-|especificado|Devuelve los primeros períodos especificados por el parámetro **periods** comenzando con la fecha **period\_from** especificada.| |especificado|especificado|-|Devuelve hasta 100 períodos dentro del rango de fechas especificado.| |especificado|especificado|especificado|Períodos de retorno especificados por el parámetro **periodos** dentro del rango de fechas especificado.| [comment]: # ({/9478a80d-31bc72e4}) [comment]: # ({af9e88c4-b46f1257}) ### Valores de retorno `(objeto)` Devuelve los resultados del cálculo. |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |periods|matriz|Lista de los períodos reportados.

Cada período reportado se representa como un objeto que consta de:
- `period_from` - Fecha de inicio del período reportado (marca de tiempo).
- `period_to` - Fecha de finalización del período informado (marca de tiempo).

Los períodos se ordenan según el campo `period_from` de forma ascendente.| |serviceids|matriz|Lista de ID de servicios en los períodos informados.

El orden de clasificación de la lista no está definido. Incluso si el parámetro `serviceids` se pasó al método `sla.getsli`.| |sli|matriz|Datos SLI (como una **matriz bidimensional**) para cada período y servicio informado.

El índice de la propiedad `periods` se utiliza como la **primera** dimensión de la propiedad `sli`.

El índice de la propiedad `serviceids` se utiliza como **segunda** dimensión de la propiedad `sli`.| [comment]: # ({/af9e88c4-b46f1257}) [comment]: # ({aa24c098-ba0b5441}) #### Datos SLI Los datos de SLI devueltos para cada período y servicio reportado consisten en: |Propiedad|[Tipo](/manual/api/reference_commentary#data_types)|Descripción| |--|--|------| |uptime|entero|Cantidad de tiempo que el servicio pasó en estado _OK_ durante el tiempo de actividad programado, menos los tiempos de inactividad excluidos.| |downtime|entero|Cantidad de tiempo que el servicio pasó en un estado _no correcto_ durante el tiempo de actividad programado, menos los tiempos de inactividad excluidos.| |sli|float|SLI (porcentaje del tiempo de actividad total), basado en el tiempo de actividad y el tiempo de inactividad.| |error\_budget|entero|Presupuesto de error (en segundos), basado en SLI y SLO.| |excluded\_downtimes|matriz|Matriz de tiempos de inactividad excluidos en este período de informe.

Cada objeto contendrá los siguientes parámetros:
- `name`: nombre del tiempo de inactividad excluido.
- `period_from ` - Fecha y hora de inicio (inclusive) del tiempo de inactividad excluido.
- `period_to` - Fecha y hora de finalización (exclusivas) del tiempo de inactividad excluido.

Los tiempos de inactividad excluidos se ordenan por campo period_from de forma ascendente.| [comment]: # ({/aa24c098-ba0b5441}) [comment]: # ({b41637d2-b41637d2}) ### Ejemplos [comment]: # ({/b41637d2-b41637d2}) [comment]: # ({new-610cd288}) #### Calculating SLI for a daily SLA Retrieve SLI data for services with IDs "1" and "4" that are linked to the SLA with ID "1". Retrieve data for a single period until "1761861599" (Oct 30 2025 23:59:59 GMT+0200). Since the [reporting period](/manual/it_services/sla) of the SLA is daily, SLI data is retrieved from "1761775200" (Oct 30 2025 00:00:00 GMT+0200) to "1761861600" (Oct 31 2025 00:00:00 GMT+0200). [Request](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "1", "serviceids": [ 1, 4 ], "periods": 1, "period_to": 1761861599, }, "id": 1 } ``` Response: ```json { "jsonrpc": "2.0", "result": { "periods": [ { "period_from": 1761775200, "period_to": 1761861600 } ], "serviceids": [ 1, 4 ], "sli": [ [ { "uptime": 43843, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Maintenance OCT", "period_from": 1761825600, "period_to": 1761829200 } ] }, { "uptime": 32225, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] } ] ] }, "id": 1 } ``` [comment]: # ({/new-610cd288}) [comment]: # ({16e0ca76-c6c818e1}) #### Calcular el SLI Recupere datos de SLI sobre servicios con ID "50", "60" y "70" que están vinculados al SLA con ID "5". Recuperar datos de 3 períodos a partir del 01 de noviembre de 2021. [Solicitud](/manual/api#performing-requests): ```json { "jsonrpc": "2.0", "method": "sla.getsli", "params": { "slaid": "5", "serviceids": [ 50, 60, 70 ], "periods": 3, "period_from": "1635724800" }, "id": 1 } ``` Respuesta: ```json { "jsonrpc": "2.0", "result": { "periods": [ { "period_from": 1635724800, "period_to": 1638316800 }, { "period_from": 1638316800, "period_to": 1640995200 }, { "period_from": 1640995200, "period_to": 1643673600 } ], "serviceids": [ 50, 60, 70 ], "sli": [ [ { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Excluded Downtime - 1", "period_from": 1637836212, "period_to": 1638316800 } ] }, { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Excluded Downtime - 1", "period_from": 1637836212, "period_to": 1638316800 } ] }, { "uptime": 1186212, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Excluded Downtime - 1", "period_from": 1637836212, "period_to": 1638316800 } ] } ], [ { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Excluded Downtime - 1", "period_from": 1638439200, "period_to": 1639109652 } ] }, { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Excluded Downtime - 1", "period_from": 1638439200, "period_to": 1639109652 } ] }, { "uptime": 1147548, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [ { "name": "Excluded Downtime - 1", "period_from": 1638439200, "period_to": 1639109652 } ] } ], [ { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] }, { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] }, { "uptime": 1674000, "downtime": 0, "sli": 100, "error_budget": 0, "excluded_downtimes": [] } ] ] }, "id": 1 } ``` [comment]: # ({/16e0ca76-c6c818e1}) [comment]: # ({13a91d62-a5414084}) ### Fuente CSla::getSli() en *ui/include/classes/api/services/CSla.php* [comment]: # ({/13a91d62-a5414084})