APIs Abiertas Insight
Introducción
Puede instalar API abiertas en su instancia del Analyzer que permiten extraer mediciones en tiempo real e indicadores clave de rendimiento (KPI) relacionados con la latencia, el caudal y la fiabilidad.
Las API pueden extraer datos seleccionados disponibles en los paneles de control visuales existentes, como la medición de la latencia por protocolo, los KPI agregados de los niveles de latencia de red y de aplicación, y nuevos calificadores de calidad de red como la volatilidad y la estabilidad.
Los datos de salida de la API se presentan en formato JSON para un par QoSAgent-Reflector determinado. El resultado puede integrarse después fácilmente en otros sistemas externos.
La API A) Connectivity Insight permite a los usuarios consultar la instancia del Analyzer para obtener datos de rendimiento de la conectividad de un QoSAgent específico utilizando su AgentID.
La API B) Throughput Insight permite a los usuarios consultar la instancia del Analyzer para obtener mediciones de caudal en tiempo real utilizando el protocolo Lifbe (cuando está configurado y activado). Los resultados de descarga y de subida en Mbps y los resultados de jitter asociados se obtienen mediante esta API.
La API C) Latency Insight puede utilizarse para obtener las mediciones de latencia de un protocolo específico y de un agente específico dentro de un intervalo de tiempo determinado por el usuario y definido en segundos.
La API D) Geoloc Insight se utiliza para consultar la última latencia media medida y sus coordenadas geográficas en formato GPS (cuando están disponibles y configuradas). Añadir el parámetro de consulta opcional time_range al endpoint /api/v1/geoloc permite a los usuarios especificar el periodo en segundos para el que desean obtener los datos históricos de geolocalización.
La API E) Twamp Insight puede utilizarse para consultar los últimos niveles de latencia detallados medidos con el protocolo TWAMP (RFC 5357) para un QoSAgent determinado. Los resultados de latencia se dividen en latencia de ida en ms, latencia de vuelta en ms y latencia de procesamiento en ms (es decir, el tiempo transcurrido en el Reflector).
La API F) Forecast Insight proporciona las últimas mediciones previstas utilizando una media estadística y una proyección.
La API G) Radio Insight proporciona las últimas mediciones de radio/celulares.
La API H) Networks proporciona todos los customer_id / redes del Analyzer.
La API I) Agents proporciona todos los QoS-Agents vinculados a un customer_id; puede incluir solo el ID o también los metadatos.
La API J) Anomalies Insight detecta e informa de las anomalías de red en todos los protocolos con métricas de anomalía detalladas y un análisis de patrones.
La API K) Performance Trends analiza las tendencias de rendimiento de los agentes a lo largo del tiempo, comparando el rendimiento actual con las referencias históricas para identificar patrones de degradación.
La API L) Health Report genera informes completos sobre la salud de la red con clasificaciones de agentes, distribución del rendimiento y recomendaciones aplicables.
La API M) Agent Rankings clasifica todos los agentes según las métricas de rendimiento y las tendencias, identificando los agentes con mejor y peor rendimiento de su red.
La API N) Correlation Analysis detecta patrones de correlación entre los agentes para identificar problemas a escala de la red que afectan a varias ubicaciones simultáneamente.
La API O) Degradation Alerts identifica de forma proactiva los agentes que presentan una degradación del rendimiento por encima de umbrales configurables durante periodos especificados.
La API P) iPerf Throughput Insight devuelve el caudal TCP y UDP de las mediciones iPerf para un QoSAgent determinado.
La API requiere que abra y proteja el puerto 12099 en su instancia del Analyzer.
Uso
Autenticación
La API utiliza la autenticación por clave API. Incluya su clave API en la cabecera x-api-key con cada solicitud:
x-api-key: your_api_key_here
Puede obtener la clave API consultando los registros del contenedor:
docker logs <api_container_ID>| grep "API Key:"
A) API Connectivity Insight
Los resultados utilizan ventanas mixtas: 10 segundos para la latencia por protocolo, 5 minutos para el jitter/volatilidad/estabilidad, 30 segundos para la QoE, 12 horas para el caudal y 1 semana para los metadatos y los valores esperados.
Se utiliza con el endpoint /api/v1/ci.
Puede ver las mediciones de los agentes utilizando los parámetros agent_id y customer_id:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/ci?agent_id=<agentID>&customer_id=<customerID>
ejemplo de salida:
{
"CustomerID": "0",
"agentID": "0",
"KPIs": {
"tcpMs": 8.94,
"udpMs": 9.53,
"httpMs": 9.09,
"httpsMs": 18,
"icmpMs": 9.2,
"twampMs": 9.45,
"downloadThroughputMbps": 1383.58,
"uploadThroughputMbps": 950.06,
"networkLatencyMs": 9.32,
"applicationLatencyMs": 11.39,
"packetLossRatePercent": 0,
"jitterMs": 6.1,
"volatilityPercent": 46.2,
"networkStabilityPercent": 65.5,
"connectivityHealth": "Warning",
"qualityOfExperience": 4.921,
"expectedLatencyMS": 40,
"expectedStabilityPercent": 98,
"expectedPacketLossPercent": 0.1
},
"Attributes": {
"time": "2025-03-26T14:01:23.305Z",
"agentName": "GenericQoSAgent",
"hardware": "Not-Applicable",
"networkName": "OutScale-Network",
"networkType": "Outscale",
"gpsPos": "48.864716,2.349014",
"details": "Generic QoSAgent preinstalled with OMI",
},
"APInotes": {
"comment": "Results from LatenceTech ConnectivityInsight API version 2.1",
"documentation": "Refer to docs.latence.ca for API details and data structure"
}
}
Nueva información de conectividad v2
GET /v2/ci?customer_id={customer_id}&agent_id={agent_id}
El endpoint v2 no proporciona los valores esperados, el volatilityPercent, el networkStabilityPercent, el connectivityHealth ni los metadatos.
Se ha diseñado como una versión ligera de /v1/ci.
B) API Throughput Insight
Devuelve los últimos valores LIFBE de las 2 últimas horas para el caudal y el jitter, y de las 12 últimas horas para la pérdida de paquetes.
Se utiliza con el endpoint /api/v1/lifbe.
Puede mostrar los datos en tiempo real de las mediciones de caudal mediante el protocolo Lifbe con los parámetros agent_id y customer_id:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/lifbe?agent_id=<agentID>&customer_id=<customerID>
ejemplo de salida:
{
"agentID": "1",
"time": "2024-05-17T15:00:04.735Z",
"lifbeDownload": 542.48,
"lifbeUpload": 49.89,
"jitterDownload": 1.23,
"jitterUpload": 3.13,
"networkInterface": "MOBILE",
"networkType": "MOBILE_5G"
}
C) API Latency Insight
Requiere time_range (segundos) o chosen_time; no hay ventana predeterminada.
Se utiliza con el endpoint /api/v1/latency.
Puede ver las mediciones de un protocolo específico para un agente específico dentro de un intervalo de tiempo determinado por el usuario añadiendo 3 argumentos opcionales a la solicitud, además de los parámetros agent_id y customer_id:
1) protocol (tcp, udp, https, httpss, icmp, twamp)
2) time_range (en segundos)
3) chosen_time
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/latency?agent_id=<agentID>&customer_id=<customerID>&protocol=tcp&time_range=400
ejemplo de salida:
[
{
"agentID": "1",
"time": "2024-05-17T15:01:26.183Z",
"measurement": "tcp_result",
"value": 15.61
},
{
"agentID": "1",
"time": "2024-05-17T15:01:28.215Z",
"measurement": "tcp_result",
"value": 15.233
}
]
Opcional: el parámetro protocol es opcional; si no se define, se mostrarán todos los protocolos.
Opcional: el uso del parámetro chosen_time le permite consultar los datos de un periodo determinado, con el formato start_time,end_time (p. ej.: 2025-05-30T10:00:00Z,2025-06-15T17:00:00Z).
No debe utilizarse con time_range.
La hora especificada debe estar en UTC o en la zona horaria configurada para el Analyzer (UTC por defecto)
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/latency?customer_id=<customerID>&agent_id=<agentID&chosen_time=2025-07-07T16:12:26Z,2025-07-07T16:12:34Z
ejemplo de salida:
[
{
"CustomerID": "0",
"agentID": "9",
"time": "2025-07-07T16:12:25.000Z",
"tcp": 46.364,
"udp": 48.355,
"http": 49.572,
"https": 96.752,
"twamp": 47.791,
"icmp": 48.5
},
{
"CustomerID": "0",
"agentID": "9",
"time": "2025-07-07T16:12:30.000Z",
"tcp": 48.233,
"udp": 48.005,
"http": 47.985,
"https": 96.531,
"twamp": 47.812,
"icmp": 48.5
}
]
D) API Geoloc Insight
Utiliza por defecto el último minuto, o el periodo definido por time_range (segundos).
Puede utilizar la aplicación móvil (o un módem/CPE con la obtención de geolocalización activada) y enviar datos GPS al Analyzer; podrá comprobar el estado actual de la latencia, así como los datos históricos con la ubicación anterior.
Se utiliza con el endpoint /api/v1/geoloc.
Puede añadir los parámetros agent_id y customer_id y un time_range opcional (en segundos) para obtener los datos históricos:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/geoloc?agent_id=<agentID>&customer_id=<customerID>
Para los datos históricos:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/geoloc?agent_id=<agentID>&customer_id=<customerID>&time_range=400
ejemplo de salida:
{
"agentID": "50",
"time": "2024-05-17T15:01:20Z",
"altitude": "39.1",
"latitude": "45.4961001",
"longitude": "-73.5619866",
"applicationLatency": 10.213
}
E) API Twamp Insight
Devuelve los últimos deltas TWAMP de los 5 últimos minutos.
Esta API puede utilizarse para consultar los últimos niveles de latencia detallados medidos con el protocolo TWAMP (RFC 5357) para un QoSAgent determinado. Los resultados de latencia son los siguientes: - TwampFwdDeltaMs = Delta de ida TWAMP (es decir, latencia entre QoSAgent -> Reflector) en milisegundos - TwampRevDeltaMs = Delta de vuelta TWAMP (es decir, latencia entre Reflector -> QoSAgent) en milisegundos - TwampProcDeltaMs = Delta de procesamiento TWAMP (es decir, latencia que se produce en el Reflector) en milisegundos
Se utiliza con el endpoint /api/v1/twamp.
Puede añadir los parámetros agent_id y customer_id:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/twamp?agent_id=<agentID>&customer_id=<customerID>
ejemplo de salida:
{
"agentID": "12",
"time": "2024-06-21T18:56:58.512Z",
"TwampFwdDeltaMs": 0.32,
"TwampRevDeltaMs": 0.94,
"TwampProcDeltaMs": 0.18,
}
F) API Forecast Insight
La latencia proyectada utiliza los 5 últimos minutos; el intervalo de previsión y el nivel de confianza se calculan sobre los 10 últimos minutos de datos de latencia.
Esta API proporciona las últimas mediciones previstas utilizando una media estadística y una proyección.
Se utiliza con el endpoint /api/v1/forecast.
Puede añadir los parámetros agent_id y customer_id:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/forecast?agent_id=<agentID>&customer_id=<customerID>
ejemplo de salida:
{
"agentID": "1",
"time": "2024-06-21T18:56:58.512Z",
"projectedLatencyMs": 1.5,
"forecastingIntervalMs": 3.28,
"confidenceLevel": 0
}
G) API Radio Insight
La última instantánea utiliza los 10 últimos segundos; con time_range o chosen_time, se devuelven los datos de esa ventana personalizada.
Esta API proporciona las últimas mediciones de radio/celulares.
Se utiliza con el endpoint /api/v1/radio.
Puede añadir los parámetros agent_id y customer_id:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/radio?agent_id=<agentID>&customer_id=<customerID>
ejemplo de salida:
{
"CustomerID": "0",
"agentID": "1",
"time": "2025-02-04T17:12:56.062Z",
"networkName": "Bell",
"networkType": "4G LTE",
"cellID": "40",
"SINR_dB": "2.147489",
"RSSI_dBm": "-63",
"RSRP_dBm": "-10",
"RSRQ_dB": "-94"
}
Opcional: el uso del parámetro chosen_time le permite consultar los datos de un periodo determinado, con el formato start_time,end_time (p. ej.: 2025-05-30T10:00:00Z,2025-06-15T17:00:00Z)
La hora especificada debe estar en UTC o en la zona horaria configurada para el Analyzer (UTC por defecto)
curl -H "x-api-key: your_api_key_here" -k https://<analyzer_IP>:12099/api/v1/radio?customer_id=<customerID>&agent_id=<agentID&chosen_time=2025-07-07T16:12:26Z,2025-07-07T16:12:34Z
ejemplo de salida:
[
{
"CustomerID": "0",
"agentID": "12",
"time": "2025-07-08T15:21:07.94Z",
"ECIO_dB": "0",
"PCI": "908",
"RSRP_dBm": "-101",
"RSRQ_dB": "-13",
"RSSI_dBm": "0",
"SINR_dB": "15.5",
"cellID": "22938075680",
"networkName": "TELUS",
"networkType": "5G"
},
{
"CustomerID": "0",
"agentID": "12",
"time": "2025-07-08T15:21:17.932Z",
"ECIO_dB": "0",
"PCI": "908",
"RSRP_dBm": "-101",
"RSRQ_dB": "-13",
"RSSI_dBm": "0",
"SINR_dB": "16",
"cellID": "22938075680",
"networkName": "TELUS",
"networkType": "5G"
},
]
H) API Networks
Lista los customer IDs vistos en la última hora.
Esta API proporciona los customer_id del Analyzer.
Se utiliza con el endpoint /api/v1/networks.
No necesita ningún parámetro
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/networks
ejemplo de salida:
{
"count": 1,
"customerId": [
"0"
]
}
I) API Agents
Lista los agentes activos en los 20 últimos segundos; los metadatos (si se solicitan) proceden de la última semana.
Esta API proporciona los customer_id del Analyzer.
Se utiliza con el endpoint /api/v1/agents.
Puede añadir el parámetro customer_id y el parámetro opcional metadata=true para recibir también los metadatos de cada agente:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/agents?customer_id=<customer_id>&metadata=true
ejemplo de salida:
{
"CustomerID": "0",
"count": 1,
"agents": [
{
"id": "9",
"name": "Montreal ref",
"networkName": "AzNet",
"networkType": "Azure Server Network",
"hardware": "Azure Server",
"details": "Azure Agent uses for Testing plateform",
"gpsPosition": "-43.8121,78.3522"
}
]
}
J) API Anomalies Insight
Requiere time_range o chosen_time; la latencia se agrega en ventanas de 30 segundos.
Esta API detecta e informa de las anomalías de red en todos los protocolos con métricas detalladas que incluyen el MAD de anomalía (Desviación Absoluta Mediana), las pérdidas de paquetes, los picos de latencia y los patrones de distribución de anomalías.
Se utiliza con el endpoint /api/v1/anomalies. Puede añadir los parámetros agent_id, customer_id, el protocol opcional (tcp, udp, http, https, icmp, twamp) y time_range (en segundos):
curl -H "x-api-key: your_api_key_here" -k -s "https://<analyzer_IP>:12099/api/v1/anomalies?agent_id=<agentID>&customer_id=<customerID>&protocol=tcp&time_range=3600"
ejemplo de salida:
{
"CustomerID": "0",
"agentID": "1",
"time": "2025-01-15T14:30:45.123Z",
"tcp": {
"anomaly_mad": 15.2,
"drops": 3,
"latency": 45.6,
"anomaly_distribution": 8.9
},
"anomaliesDetected": true,
"summary": "El protocolo TCP muestra indicadores de anomalía elevados"
}
K) API Performance Trends
Compara la latencia media de la última hora con una referencia de los N días anteriores (por defecto 7, hasta ayer).
Esta API analiza las tendencias de rendimiento de los agentes a lo largo del tiempo, comparando el rendimiento actual con las referencias históricas para identificar patrones de degradación y el estado del rendimiento.
Se utiliza con el endpoint /api/v1/trends. Puede añadir los parámetros agent_id, customer_id y el parámetro opcional lookback_days:
curl -H "x-api-key: your_api_key_here" -k -s "https://<analyzer_IP>:12099/api/v1/trends?agent_id=<agentID>&customer_id=<customerID>&lookback_days=7"
ejemplo de salida:
{
"CustomerID": "0",
"agentID": "1",
"time": "2025-01-15T14:30:45.123Z",
"currentLatency": 42.5,
"baselineLatency": 35.2,
"trendPercentage": 20.7,
"status": "DEGRADED",
"lookbackDays": 7
}
L) API Health Report
Agrega la latencia media durante el periodo del informe: 1 día (daily), 7 días (weekly) o 30 días (monthly).
Esta API genera informes completos sobre la salud de la red con la distribución del rendimiento de los agentes, las clasificaciones y recomendaciones aplicables para la optimización de la red.
Se utiliza con el endpoint /api/v1/health-report. Puede añadir los parámetros customer_id, el report_period opcional (daily, weekly, monthly) e include_recommendations (true/false):
curl -H "x-api-key: your_api_key_here" -k -s "https://<analyzer_IP>:12099/api/v1/health-report?customer_id=<customerID>&report_period=daily&include_recommendations=true"
ejemplo de salida:
{
"CustomerID": "0",
"reportPeriod": "daily",
"generatedAt": "2025-01-15T14:30:45.123Z",
"summary": {
"totalAgents": 5,
"healthDistribution": {
"good": 3,
"fair": 1,
"poor": 1
},
"overallScore": 76.0
},
"agentDetails": [
{
"agentID": "1",
"avgLatency": 25.3,
"status": "GOOD"
},
{
"agentID": "2",
"avgLatency": 65.8,
"status": "FAIR"
},
{
"agentID": "3",
"avgLatency": 120.4,
"status": "POOR"
}
],
"recommendations": [
"5 agentes supervisados en total",
"3 agentes tienen un buen rendimiento",
"1 agentes requieren atención",
"1 agentes requieren una investigación inmediata",
"Prioridad: Investigar los agentes con estado POOR"
]
}
M) API Agent Rankings
Clasifica los agentes según la latencia media durante time_range segundos (por defecto 24 horas).
Esta API clasifica todos los agentes según las métricas de rendimiento y las tendencias, identificando los agentes con mejor y peor rendimiento con puntuaciones de rendimiento detalladas y un análisis comparativo.
Se utiliza con el endpoint /api/v1/agent-rankings. Puede añadir los parámetros customer_id, la metric opcional (latency, stability, connectivity_health, overall) y time_range (en segundos):
curl -H "x-api-key: your_api_key_here" -k -s "https://<analyzer_IP>:12099/api/v1/agent-rankings?customer_id=<customerID>&metric=overall&time_range=86400"
ejemplo de salida:
{
"CustomerID": "0",
"metric": "overall",
"timeRangeSeconds": 86400,
"generatedAt": "2025-01-15T14:30:45.123Z",
"totalAgents": 5,
"rankings": [
{
"agentID": "1",
"avgLatency": 22.4,
"performanceScore": 77.6,
"rank": 1
},
{
"agentID": "3",
"avgLatency": 45.2,
"performanceScore": 54.8,
"rank": 2
},
{
"agentID": "2",
"avgLatency": 85.7,
"performanceScore": 14.3,
"rank": 3
}
],
"topPerformer": {
"agentID": "1",
"avgLatency": 22.4,
"performanceScore": 77.6,
"rank": 1
},
"bottomPerformer": {
"agentID": "2",
"avgLatency": 85.7,
"performanceScore": 14.3,
"rank": 3
}
}
N) API Correlation Analysis
Analiza la latencia durante time_range segundos (por defecto 2 horas), agregada en ventanas de 5 minutos.
Esta API detecta patrones de correlación entre los agentes para identificar problemas a escala de la red que afectan a varias ubicaciones, con un análisis estadístico de correlación y una clasificación de los patrones.
Se utiliza con el endpoint /api/v1/correlation-analysis. Puede añadir los parámetros customer_id, el correlation_threshold opcional (0.0-1.0) y time_range (en segundos):
curl -H "x-api-key: your_api_key_here" -k -s "https://<analyzer_IP>:12099/api/v1/correlation-analysis?customer_id=<customerID>&correlation_threshold=0.7&time_range=7200"
ejemplo de salida:
{
"CustomerID": "0",
"time": "2025-01-15T14:30:45.123Z",
"correlationThreshold": 0.7,
"timeRangeSeconds": 7200,
"totalAgentsAnalyzed": 4,
"patternsFound": 2,
"patterns": [
{
"description": "Agentes que presentan patrones similares de degradación de la latencia",
"affectedAgents": ["1", "2", "4"],
"correlationStrength": 0.85,
"patternType": "similar_degradation",
"severity": "MEDIUM",
"recommendation": "Investigar la infraestructura de red compartida: varios agentes afectados de forma similar"
},
{
"description": "Agentes que presentan patrones de latencia inversos",
"affectedAgents": ["3", "5"],
"correlationStrength": 0.72,
"patternType": "inverse_pattern",
"severity": "LOW",
"recommendation": "Comprobar el comportamiento del balanceo de carga o de la conmutación por error que afecta a distintos agentes"
}
]
}
O) API Degradation Alerts
Compara la latencia media de la última hora con una referencia de lookback_days días (por defecto 3, hasta ayer).
Esta API identifica de forma proactiva los agentes que presentan una degradación del rendimiento por encima de umbrales configurables, con una clasificación de la gravedad y un análisis detallado de la degradación.
Se utiliza con el endpoint /api/v1/degradation-alerts. Puede añadir los parámetros customer_id, el severity_threshold opcional (porcentaje) y lookback_days:
curl -H "x-api-key: your_api_key_here" -k -s "https://<analyzer_IP>:12099/api/v1/degradation-alerts?customer_id=<customerID>&severity_threshold=20&lookback_days=3"
ejemplo de salida:
{
"CustomerID": "0",
"time": "2025-01-15T14:30:45.123Z",
"alertCount": 2,
"severityThreshold": 20,
"daysLookback": 3,
"alerts": [
{
"agentID": "3",
"degradationPercent": 45.2,
"currentLatency": 78.5,
"baselineLatency": 54.1,
"severity": "HIGH",
"message": "El agente 3 presenta una degradación del rendimiento del 45,2 % en 3 días"
},
{
"agentID": "2",
"degradationPercent": 22.8,
"currentLatency": 55.3,
"baselineLatency": 45.0,
"severity": "MEDIUM",
"message": "El agente 2 presenta una degradación del rendimiento del 22,8 % en 3 días"
}
]
}
P) API iPerf Throughput Insight
Devuelve el último caudal iPerf TCP y UDP de las 12 últimas horas.
Esta API devuelve el caudal TCP y UDP procedente de las mediciones iPerf para un QoSAgent determinado.
Se utiliza con el endpoint /api/v1/iperf.
Puede añadir los parámetros agent_id y customer_id:
curl -H "x-api-key: your_api_key_here" -s -k https://<analyzer_IP>:12099/api/v1/iperf?agent_id=<agentID>&customer_id=<customerID>
ejemplo de salida:
{
"CustomerID": "0",
"agentID": "1",
"time": "2026-06-15T14:59:46.207Z",
"tcp": {
"downloadThroughputMbps": 380.38,
"uploadThroughputMbps": 246.02
},
"udp": {
"downloadThroughputMbps": 120.5,
"uploadThroughputMbps": 98.3
}
}
Definición de la API
Hay disponible un archivo de definición de la API conforme a la norma OpenAPI en formato yml. Puede descargar el archivo aquí:
wget https://api.latence.ca/software/latencetech_api_definition.yml
Resolución de problemas
customerID is required o agentID is required.
Es posible, según el entorno que utilice, que la parte del Analyzer de la solicitud deba ir entre comillas:
curl -H "x-api-key: your_api_key_here" -s -k "https://<analyzer_IP>:12099/api/v1/ci?agent_id=<agentID>&customer_id=<customerID>"