API yang berkelanjutan secara lingkungan di Azure API Management (pratinjau)

BERLAKU UNTUK: Pengembang | Dasar | Standar | Premi

Artikel ini memperkenalkan fitur di Azure API Management yang membantu Anda mengurangi jejak karbon lalu lintas API Anda. Gunakan fitur untuk menyesuaikan lalu lintas API berdasarkan emisi karbon di berbagai wilayah Azure.

Nota

  • Fitur keberlanjutan lingkungan saat ini dalam pratinjau terbatas. Untuk mendaftar, lengkapi formulir.
  • Fitur-fitur ini saat ini tersedia di wilayah tertentu di tingkat klasik Azure API Management (Pengembang, Dasar, Standar, Premium).

Tentang API berkelanjutan

Organisasi semakin berfokus pada pengurangan dampak lingkungan mereka melalui infrastruktur digital mereka.

API Management memungkinkan Anda mencapai tujuan ini dengan fitur yang membantu:

Dengan mengoptimalkan cara API Anda menangani lalu lintas berdasarkan faktor lingkungan, Anda dapat:

  • Mengurangi emisi karbon lalu lintas API Anda
  • Mendukung inisiatif keberlanjutan perusahaan dan komitmen lingkungan
  • Menunjukkan tanggung jawab lingkungan kepada pemangku kepentingan

Perubahan lalu lintas

Pergeseran lalu lintas memerlukan konfigurasi sumber daya backend di wilayah Azure yang didukung yang menyediakan informasi intensitas karbon. Kemudian, dalam kumpulan backend beban seimbang, tentukan tingkat emisi karbon maksimum yang dapat diterima untuk menggunakan backend berbasis regional, dengan menggunakan salah satu dari kategori intensitas karbon.

Kemampuan ini, dikombinasikan dengan strategi penyeimbangan beban dan perutean yang ada, membantu Anda mengecualikan lalu lintas menuju backend di wilayah dengan emisi karbon yang relatif lebih tinggi.

Pada waktu eksekusi

  • API Management melakukan upaya terbaik untuk merutekan lalu lintas ke backend "hijau" (di wilayah dengan emisi di bawah ambang batas yang Anda tentukan) dan mengecualikan backend "kotor" (di wilayah dengan emisi di atas ambang yang ditentukan).
  • API Management merutekan lalu lintas ke backend "kotor" dalam kondisi tertentu untuk memastikan kelangsungan layanan - misalnya, ketika semua backend regional "kotor", dan backend lainnya tidak tersedia.

Diagram mengalihkan lalu lintas ke backend dengan emisi yang lebih rendah dalam kumpulan seimbang beban.

Contoh konfigurasi

Pertama, konfigurasikan backend di wilayah Azure yang didukung dengan mengatur properti opsional azureRegion :

{
    "type": "Microsoft.ApiManagement/service/backends", 
    "apiVersion": "2024-10-01-preview", 
    "name": "sustainable-backend", 
    "properties": {
        "url": "https://mybackend.example.com",
        "protocol": "http",
        "azureRegion": "westeurope",
        [...]
  }
}

Kemudian, gunakan backend yang terlokalisasi secara regional dalam pool yang diseimbangkan beban dan tentukan ambang emisi menggunakan preferredCarbonEmission property.

Dalam contoh ini, jika intensitas karbon di wilayah melebihi westeuropeMedium, lalu lintas ke sustainable-backend dikecualikan dibandingkan dengan backend lain di kumpulan.

{
    [...]
    "properties": {
        "description": "Load balancer for multiple backends",
        "type": "Pool",
        "pool": {
            "services": [
                {
                    "id": "<sustainable-backend-id>",
                    "weight": 1,
                    "priority": 1,
                    "preferredCarbonEmission": "Medium"
                }
                {
                    
                    "id": "<regular-backend-id>",
                    "weight": 1,
                    "priority": 1
                }
                {
                    "id": "<fallback-backend-id>",
                    "weight": 1,
                    "priority": 2
                }
            ]
        }
    }
} 

Pengaturan lalu lintas

Pengaturan lalu lintas memungkinkan Anda menyesuaikan perilaku API berdasarkan tingkat emisi karbon relatif di satu atau lebih wilayah layanan API Management Anda. API Management memaparkan context.Deployment.SustainabilityInfo.CurrentCarbonIntensityvariabel konteks, yang menunjukkan kategori intensitas karbon saat ini untuk instans API Management Anda.

Dalam penyebaran multi-wilayah, gateway menyediakan intensitas karbon dari wilayah masing-masing di mana gateway beroperasi.

Gunakan variabel konteks ini dalam kebijakan Anda untuk memungkinkan pemrosesan lalu lintas yang lebih intensif selama periode emisi karbon rendah, atau mengurangi pemrosesan selama emisi karbon tinggi.

Contoh: Menyesuaikan perilaku dalam periode emisi karbon tinggi

Dalam contoh berikut, API Management memperluas durasi cache, menerapkan pembatasan laju yang lebih ketat, dan mengurangi detail pengelogan selama periode emisi karbon tinggi.

<policies>
    <inbound>
        <base />
        <choose>
          <when condition="@(context.Deployment.SustainabilityInfo.CurrentCarbonIntensity == CarbonIntensityCategory.High)">
            <!-- Policies for high carbon emission periods -->
            <cache-store duration="3600" />
            <rate-limit-by-key calls="100" renewal-period="60" counter-key="@(context.Request.IpAddress)" />
            <set-variable name="enableDetailedLogging" value="false" />
          </when>
          <when condition="@(context.Deployment.SustainabilityInfo.CurrentCarbonIntensity == CarbonIntensityCategory.Medium)">
            <!-- Policies for medium carbon emission periods -->
            <cache-store duration="1800" />
            <rate-limit-by-key calls="200" renewal-period="60" counter-key="@(context.Request.IpAddress)" />
            <set-variable name="enableDetailedLogging" value="true" />
          </when>
          <otherwise>
            <!-- Policies for low carbon emission periods -->
            <cache-store duration="900" />
            <rate-limit-by-key calls="300" renewal-period="60" counter-key="@(context.Request.IpAddress)" />
            <set-variable name="enableDetailedLogging" value="true" />
          </otherwise>
        </choose>
    
        <!-- Use the logging variable elsewhere -->
        <choose>
          <when condition="@(context.Variables.GetValueOrDefault<bool>("enableDetailedLogging"))">
            <log-to-eventhub logger-id="detailed-logger">
              @{
                  return JObject.FromObject(context).ToString();
              }
            </log-to-eventhub>
          </when>
          <otherwise>
            <log-to-eventhub logger-id="basic-logger">
              @{
                  var log = new JObject();
                  log["requestId"] = context.RequestId;
                  log["method"] = context.Request.Method;
                  log["url"] = context.Request.Url.ToString();
                  log["statusCode"] = context.Response.StatusCode;
                  return log.ToString();
              }
            </log-to-eventhub>
          </otherwise>
        </choose>
    </inbound>
    [...]    
</policies>

Contoh: Menyebarkan informasi intensitas karbon ke backend atau dalam log

Contoh berikut menunjukkan cara mengakses intensitas karbon saat ini dan menyebarkannya ke backend atau log.

<policies>
    [...]
    <outbound>
        <base />
        <set-header name="X-Sustainability-CarbonEmission" exists-action="override">
            <value>@(context.Deployment.SustainabilityInfo.CurrentCarbonIntensity.ToString())</value>
        </set-header>
    </outbound>
    [...]
</policies>

Contoh: Menyesuaikan verbositas pelacakan berdasarkan intensitas karbon

Contoh berikut menunjukkan cara menggunakan informasi intensitas karbon saat ini untuk menyesuaikan jumlah informasi yang disebarkan dalam jejak kustom.

<policies>
    [...]
    <inbound>
        <base />
        <choose>
            <when condition="@(context.Deployment.SustainabilityInfo.CurrentCarbonIntensity >= CarbonIntensityCategory.High)">
                <trace source="Orders API" severity="verbose">
                    <message>Lead Created</message>
                </trace>
            </when>
            <otherwise>
                <trace source="Orders API" severity="information">
                    <message>Lead Created</message>
                </trace>
            </otherwise>
        </choose>
    </inbound>
    [...]    
</policies>

Ketersediaan regional

Tabel berikut menunjukkan:

  • Wilayah di mana instans pada lapisan API Management Classic (Pengembang, Dasar, Standar, Premium) mendukung fitur keberlanjutan (setelah mendaftar pratinjau)
  • Wilayah tempat informasi tentang intensitas emisi karbon tersedia, misalnya, untuk membuat backend regional untuk pergeseran lalu lintas
Wilayah Dukungan Manajemen API Informasi intensitas karbon
Australia Tengah ✅
Australia Tengah 2 ✅
Australia Timur ✅ ✅
Australia Tenggara ✅ ✅
Brasil Selatan ✅ ✅
Brasil Tenggara ✅
Kanada Tengah ✅
Kanada Timur ✅ ✅
India Tengah ✅ ✅
US Tengah ✅ ✅
Chili Tengah ✅
Asia Timur ✅
US Timur ✅ ✅
US Timur 2 ✅ ✅
Prancis Tengah ✅
Prancis Selatan ✅ ✅
Jerman Utara ✅
Jerman Barat Tengah ✅ ✅
Indonesia Tengah ✅
Israel Tengah ✅ ✅
Italia Utara ✅ ✅
Jepang Timur ✅ ✅
Jepang Barat ✅ ✅
Jio India Tengah ✅
Jio India Barat ✅ ✅
Korea Tengah ✅
Korea Selatan ✅
Malaysia Selatan ✅
Meksiko Tengah ✅ ✅
Selandia Baru Utara ✅ ✅
US Tengah Utara ✅
Eropa Utara ✅ ✅
Norwegia Timur ✅ ✅
Norwegia Barat ✅
Polandia Tengah ✅ ✅
Qatar Tengah ✅ ✅
Afrika Selatan Utara ✅ ✅
Afrika Selatan Barat ✅
US Tengah Selatan ✅
India Selatan ✅ ✅
Asia Tenggara ✅
Spanyol Tengah ✅ ✅
Swedia Tengah ✅ ✅
Swedia Selatan ✅
Swiss Utara ✅ ✅
Swiss Barat ✅ ✅
Taiwan Utara ✅ ✅
Taiwan Barat Laut ✅
Taiwan Barat ✅
UAE Tengah ✅
UAE Utara ✅ ✅
UK Selatan ✅ ✅
UK Barat ✅ ✅
Barat Sentral AS ✅ ✅
Eropa Barat ✅ ✅
India Barat ✅
US Barat ✅ ✅
Barat AS 2 ✅ ✅
Barat AS 3 ✅ ✅

Kategori intensitas karbon

Tabel berikut menjelaskan kategori intensitas karbon yang digunakan dalam pergeseran lalu lintas dan fitur pembentukan lalu lintas. Nilai dalam gram CO₂e per KWh untuk emisi cakupan 2.

Kategori g CO₂e
Tidak Tersedia N/A
Sangat Rendah ≤ 150
Low 151-300
Menengah 301-500
High 501-700
Sangat Tinggi > 700