Package com.eqixiac.equinix.design.estate
package com.eqixiac.equinix.design.estate
Estate analysis: looks at what a customer already runs on Equinix and produces a priced,
evidence-backed improvement report. Read-only: nothing in this package changes a resource.
EstateCollectorreads a scoped, immutableEstateInventory(ports, connections, Cloud Routers, networks, service tokens, Network Edge devices) with bounded paging, recording anything it cannot read as a coverage gap.UtilizationProbereduces Fabric bandwidth metrics to p50/p95/peak per connection (UtilizationSnapshot); missing data is unknown, never zero.EstateRules (defaults indesign.estate.rules) turn the snapshot intoEstateFindings, priced through aRateCardbyEstatePricing.EstateReportorders, totals (per currency) and renders them (Markdown and JSON).EstateAnalyzeris the entry point, live (builder(fabric)) or offline (fromSnapshot(inventory)).
-
ClassDescriptionHow sure the analyser is that an
EstateFindingis right.Analyses what a customer already runs on Equinix and produces a priced, evidence-backed improvement report.Configures and runs an analysis.Reads a scoped estate snapshot from the live APIs.One evidence-backed improvement to an existing estate.A figure that supports a finding.A resource a finding is about.An immutable, serializable snapshot of the part of an Equinix estate an analysis covers.Builds an inventory by hand.How the snapshot was collected.A Fabric virtual connection.Something the collector could not read, recorded instead of failing the run.A Network Edge virtual device.One side of a virtual connection.A Fabric network (EVPLAN, EPLAN, IPWAN...).A Fabric port.A Fabric Cloud Router.A Fabric service token.Collection figures for one resource type.Prices existing resources through aRateCardand turns each quote into aCostLinewith a range that reflects its provenance: live Equinix, contract (CUSTOM) and provider-API prices are exact; reference prices get ±EstateThresholds.referencePriceRangePercent(); estimates get ±EstateThresholds.estimatePriceRangePercent().The result of a price lookup: a cost line, or the reason there is none.The result of an estate analysis: findings in priority order, totals, the addressable saving per currency, coverage gaps, and what was not analysed.One entry of the prioritised action list.Totals for one category.An addressable saving in one currency.A finding whose financial effect could not be priced.What utilisation data the analysis had.One analysis rule: a small, pure function from an estate snapshot (and optional utilisation) to findings.Which part of an Equinix estate an analysis reads.The tunable thresholds the default rules use.Builds thresholds, starting from the defaults.The money a finding's recommended action would save (positive) or cost (negative), with where the figures came from and how far they could be off.The kind of impact.What kind of improvement anEstateFindingproposes.What a rule may use besides the inventory and utilisation: pricing, thresholds, and the time the analysis treats as "now" (the snapshot's as-of time, so offline re-runs give the same result).How urgent anEstateFindingis.Reads bandwidth utilisation for the live connections (and optionally the active ports) of an inventory throughPOST /fabric/v4/metrics/searchand reduces it to p50 / p95 / peak.Configures a probe.Fetches the metrics of one search.Pauses between requests (replaceable in tests).Bandwidth utilisation of the resources in an estate over one time window, reduced to percentiles.Utilisation of one resource.