Grid Integrator SDK

Overview

The Grid Integrator SDK provides tools for integrating grid intelligence solutions with DPS datacenter power management. NvGrid operates at the power feed level, providing granular control over individual electrical circuits or datacenter-wide power consumption.

Grid integrators use the NvGrid gRPC API to schedule power constraints, receive power event notifications, and coordinate datacenter operations with utility grid requirements.

Integration scenarios include utility curtailment and demand response, emergency load shedding during grid instability, dynamic pricing optimization, renewable energy coordination, and grid stability support.

Target Persona

Grid Integration Engineer: Developer creating solutions that connect electrical utility grids with datacenter power management systems.

Capabilities:

Schedule power constraint changes, such as planned power reductions, based on grid signals
Monitor power utilization and target achievement through webhooks
Query current power status and feed metadata
Implement demand response programs
Manage load curtailment events

SDK Components

Prerequisites - Infrastructure, development tools, and testing environment setup
Core Concepts - Architectural principles, power management strategy, and feed management
API Specification - Complete NvGrid gRPC API reference with methods, messages, and data structures
Managing Power Constraints - Schedule load targets and manage power constraints across datacenter feeds
Monitoring Power Events - Register webhooks and receive power event notifications

Getting Started

Integrate grid solutions with DPS using the NvGrid gRPC API. Begin by reviewing prerequisites and core concepts, then explore the API specification before implementing power constraint management and event monitoring.

Security Note: Webhook URLs must be configured in the DPS server whitelist for event notifications. See Prerequisites for webhook security configuration details.

Integration Architecture

graph TB
    A[Grid Solution] --> B[NvGrid API]
    B --> C[DPS Scheduler]
    C --> D[Grid Controller]
    D --> E[Datacenter Resources]

    C --> F[Webhook Notifications]
    F --> A

    E --> G[Power Metrics]
    G --> C

    subgraph "Grid Events"
    H[Curtailment Signal]
    I[Pricing Event]
    J[Demand Response]
    end

    H --> A
    I --> A
    J --> A