Environment and power

Sensor readings, power events and alert configurations, facility system alerts, and trending data.

Environmental readings#

Java

import com.eqixiac.equinix.ibxsmartview.model.SensorReading;

for (SensorReading reading : smartView.environmentals().list("DC6")) {
    System.out.println(reading.getSensorId() + " zone " + reading.getZoneId()
        + " temperature " + reading.getTemperature() + " humidity " + reading.getHumidity());
}

list(ibx) returns every sensor reading of an IBX as a paginated list. The five-argument form filters by sensor type and zone and sets the offset and limit. getSensorReading(ibx, sensorId) reads one sensor.

Power events#

Java

import com.eqixiac.equinix.ibxsmartview.model.PowerEvent;
import com.eqixiac.equinix.ibxsmartview.model.SystemAlert;

for (PowerEvent event : smartView.powerEvents().search(List.of("DC6", "DC11"), null, null, 0, 50)) {
    System.out.println(event.getEventType() + " " + event.getStatus() + " " + event.getConditionType()
        + " trigger " + event.getTriggerValue() + " current " + event.getCurrentValue());
}

for (SystemAlert alert : smartView.systemAlerts().search("ACTIVE", null, null, 0, 50)) {
    System.out.println(alert);
}

The arguments of powerEvents().search are the IBX list, a status list, a search text, the offset and the limit. defineAlertConfiguration() creates a power alert with thresholds. pauseAlertConfiguration, resumeAlertConfiguration and deleteAlertConfiguration manage it.

Alert configurations#

A power alert configuration notifies when power draw crosses a threshold that you set.

Method	Effect
`defineAlertConfiguration()`	Starts the builder for a new configuration
`searchAlertConfigurations(ibxs, statuses, offset, limit)`	Lists configurations
`updateAlertConfiguration(id)`	Starts the builder for a change
`pauseAlertConfiguration(id)`, `resumeAlertConfiguration(id)`	Suspends and resumes notifications
`deleteAlertConfiguration(id)`	Removes the configuration

System alerts#

systemAlerts().search(status, ...) returns facility alerts on the electrical and mechanical infrastructure, as in the block above. searchPost(SearchRequest) takes the filter as a request body.

History and trends#

The v1 clients return current and trending values per account and IBX.

Client	Methods
`legacyEnvironmentals()`	`getCurrent(...)`, `listCurrent(...)`, `getTrending(...)`: temperature and humidity now and over an interval
`legacyPower()`	`getCurrent(...)`, `postCurrent(PowerCurrentPostRequest)`, `getTrending(...)`: power draw now and over an interval

MCP tools: ibx_get_environmentals and ibx_list_power_events (MCP server).