DocumentazioneExperience PlatformDocumentazione API del server di rete Edge

Guardrail delle prestazioni per Edge Network Server API

Last update: Fri Nov 22 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Argomenti:

Creato per:

  • Sviluppatore

Panoramica overview

I guardrail delle prestazioni definiscono i limiti di utilizzo relativi ai casi di utilizzo dell’API server. Il superamento dei guardrail delle prestazioni descritti in questo articolo potrebbe causare un peggioramento delle prestazioni.

Adobe non è responsabile del deterioramento delle prestazioni causato dal superamento dei limiti di utilizzo. I clienti che superano costantemente i guardrail delle prestazioni possono richiedere una capacità di elaborazione aggiuntiva per evitare il degrado delle prestazioni.

IMPORTANT
Controlla i diritti di licenza nell'ordine di vendita e la corrispondente descrizione del prodotto sui limiti di utilizzo effettivi, oltre a questa pagina di guardrail.

Tutti i guardrail delle prestazioni descritti in questa pagina si applicano a livello di organizzazione IMS. Per gli utenti con più organizzazioni IMS configurate, ogni organizzazione è soggetta singolarmente ai guardrail delle prestazioni riportati di seguito. Per ulteriori dettagli su IMS Organizations, vedere il glossario di Experience Platform.

Definizioni

  • Disponibilità viene calcolata per ogni intervallo di cinque minuti come percentuale di richieste elaborate dall'Edge Network di Experience Platform che non hanno esito negativo con errori e si riferiscono solo alle API di Edge Network con provisioning. Se un tenant non ha effettuato richieste in un determinato intervallo di cinque minuti, tale intervallo viene considerato disponibile al 100%.
  • La percentuale di tempo di attività mensile per una determinata area viene calcolata come media della disponibilità per tutti gli intervalli di cinque minuti in un mese.
  • Un upstream è un servizio dietro l'Edge Network, abilitato per un flusso di dati specifico, ad esempio Adobe Server Side Forwarding, Adobe Edge Segmentation o Adobe Target.
  • Una unità di richiesta corrisponde a un frammento di 8 KB di una richiesta e una a monte configurata per uno stream di dati.
  • Una richiesta è un singolo messaggio inviato da un'applicazione di proprietà del cliente a Server API. Una richiesta può contenere una o più unità di richiesta.
  • Un errore è una richiesta non riuscita a causa di un errore del servizio interno di Edge Network 🔗.

Limiti del servizio

Tutti gli stream di dati applicano determinati limiti di utilizzo, che controllano principalmente il numero di eventi che possono essere inviati contemporaneamente, la loro dimensione e il numero di servizi a monte a cui tali richieste vengono indirizzate.

Unità di richiesta

Tutti i limiti vengono applicati e normalizzati su una unità di richiesta (RU), definita come frammento 8 KB di una richiesta indirizzata a un servizio upstream configurato in un flusso di dati.

Esempi

Flussi a monte configurati per flusso di dati
Dimensione media della richiesta
Unità di richiesta
1 (piattaforma Adobe)
8 KB (1 frammento)
1
2 (Adobe Platform, Adobe Target)
8 KB (1 frammento)
2
2 (Adobe Platform, Adobe Target)
16 KB (2 frammenti)
4
2 (Adobe Platform, Adobe Target)
64 KB (8 frammenti)
16

Limiti unità di richiesta

La tabella seguente mostra i valori limite predefiniti. Se hai bisogno di limiti di unità di richiesta più elevati, contatta il rappresentante del tuo account.

Endpoint
Richieste unità al secondo
/v2/interact
4000
/v2/collect
6000

Limite dimensione richiesta HTTP

Formato payload
Dimensione massima per una richiesta
Massimo 8 KB di frammenti di richiesta
Testo normale JSON
64 KB
8
NOTE
A seconda del payload stesso, i formati binari sono generalmente più compatti del 20-40%, consentendo di inviare più dati di quanti ne avresti in JSON in formato testo normale. Contatta il rappresentante dell’Assistenza clienti se hai bisogno di una capacità più elevata per i flussi di dati.

Passaggi successivi

Consulta la seguente documentazione per ulteriori informazioni su altri guardrail dei servizi Experience Platform, informazioni sulla latenza end-to-end e informazioni sulle licenze dai documenti di descrizione del prodotto Real-Time CDP:

recommendation-more-help
f36c2cef-1417-40aa-a11d-5d0abaee121b