Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
Con i log CloudFront in tempo reale, puoi ottenere informazioni sulle richieste fatte a una distribuzione in tempo reale (i log vengono consegnati entro pochi secondi dalla ricezione delle richieste). È possibile utilizzare i registri in tempo reale per monitorare, analizzare e agire in base alle prestazioni di distribuzione dei contenuti.
CloudFront i log in tempo reale sono configurabili. È possibile scegliere:
-
Puoi scegliere la frequenza di campionamento per i log in tempo reale, ossia la percentuale di richieste per cui desideri ricevere log in tempo reale.
-
I campi specifici che si desidera ricevere nei record di registro.
-
I comportamenti specifici della cache (pattern di percorso) per i quali si desidera ricevere i registri in tempo reale.
CloudFront i log in tempo reale vengono inviati al flusso di dati di tua scelta in Amazon Kinesis Data Streams. Puoi creare il tuo consumer Kinesis Data Stream o utilizzare Amazon Data Firehose per inviare i dati di log ad Amazon Simple Storage Service (Amazon S3), Amazon Redshift, Amazon Service (Service) o a un OpenSearch servizio di elaborazione dei OpenSearch log di terze parti.
CloudFront addebiti per i log in tempo reale, oltre ai costi sostenuti per l'utilizzo di Kinesis Data Streams. Per ulteriori informazioni sui prezzi, consulta i prezzi di Amazon e CloudFront i prezzi
Importante
Ti consigliamo di utilizzare i log per comprendere la natura delle richieste per i tuoi contenuti, non come contabilità completa di tutte le richieste. CloudFront fornisce log in tempo reale con la massima diligenza possibile. È possibile che la voce di log per una specifica richiesta venga distribuita molto tempo dopo l'elaborazione effettiva della richiesta e, in rari casi, che non venga distribuita affatto. Quando una voce di registro viene omessa dai registri in tempo reale, il numero di voci nei registri in tempo reale non corrisponderà all'utilizzo visualizzato nei report di fatturazione e utilizzo. AWS
Argomenti
Crea e utilizza configurazioni di registro in tempo reale
Per ottenere informazioni sulle richieste fatte a una distribuzione in tempo reale, puoi utilizzare configurazioni di registro in tempo reale. I log vengono consegnati entro pochi secondi dalla ricezione delle richieste. È possibile creare una configurazione di log in tempo reale nella CloudFront console, con AWS Command Line Interface (AWS CLI) o con l' CloudFront API.
Per utilizzare una configurazione di registro in tempo reale, è necessario collegarla a uno o più comportamenti della cache in una CloudFront distribuzione.
Per creare una configurazione di log in tempo reale
-
Accedi AWS Management Console e apri la pagina dei log nella CloudFront console all'indirizzohttps://console.aws.amazon.com/cloudfront/v4/home?#/logs
. -
Scegli la scheda Configurazioni in tempo reale.
-
Scegli Crea configurazione.
-
In Nome, inserisci un nome per la configurazione.
-
Per Frequenza di campionamento, inserite la percentuale di richieste per le quali desiderate ricevere i record di registro.
-
Per Fields, scegliete i campi da ricevere nei log in tempo reale.
-
Per includere tutti i campi CMCD per i tuoi registri, scegli CMCD tutte le chiavi.
-
-
Per Endpoint, scegli uno o più flussi di dati Kinesis per ricevere i log in tempo reale.
Nota
CloudFront i log in tempo reale vengono inviati al flusso di dati specificato in Kinesis Data Streams. Per leggere e analizzare i log in tempo reale, puoi creare il tuo utente Kinesis Data Stream Consumer. Puoi anche utilizzare Firehose per inviare i dati di registro ad Amazon S3, Amazon Redshift, OpenSearch Amazon Service o a un servizio di elaborazione dei log di terze parti.
-
Per il ruolo IAM, scegli Crea nuovo ruolo di servizio o scegli un ruolo esistente. È necessario disporre dell'autorizzazione per creare i ruoli IAM.
-
(Facoltativo) Per la distribuzione, scegli un comportamento di CloudFront distribuzione e cache da collegare alla configurazione del registro in tempo reale.
-
Scegli Crea configurazione.
In caso di successo, la console mostra i dettagli della configurazione del registro in tempo reale appena creata.
Per ulteriori informazioni, consulta Comprendi le configurazioni dei log in tempo reale.
Comprendi le configurazioni dei log in tempo reale
Per utilizzare i log CloudFront in tempo reale, iniziate creando una configurazione di log in tempo reale. La configurazione del registro in tempo reale contiene informazioni sui campi di registro che si desidera ricevere, la frequenza di campionamento per i record di registro e il flusso di dati Kinesis in cui si desidera consegnare i registri.
In particolare, una configurazione di registro in tempo reale contiene le seguenti impostazioni:
Nome
Un nome per identificare la configurazione del registro in tempo reale.
Velocità di campionamento
La frequenza di campionamento è un numero intero compreso tra 1 e 100 (incluso) che determina la percentuale di richieste di visualizzatore inviate a Kinesis Data Streams come record di registro in tempo reale. Per includere ogni richiesta di visualizzatore nei registri in tempo reale, specificare 100 per la frequenza di campionamento. È possibile scegliere una frequenza di campionamento inferiore per ridurre i costi pur ricevendo un campione rappresentativo di dati di richiesta nei registri in tempo reale.
Campi
Un elenco di campi inclusi in ogni record di log in tempo reale. Ogni record di registro può contenere fino a 40 campi ed è possibile scegliere di ricevere tutti i campi disponibili o solo i campi necessari per il monitoraggio e l'analisi delle prestazioni.
L'elenco seguente contiene ogni nome di campo e una descrizione delle informazioni contenute in tale campo. I campi vengono elencati nell'ordine in cui vengono visualizzati nei record di registro che vengono recapitati a Kinesis Data Streams.
I campi 46-63 sono dati comuni dei client multimediali (CMCD) a cui i client dei lettori multimediali possono inviare con ogni richiesta. CDNs È possibile utilizzare questi dati per comprendere ogni richiesta, ad esempio il tipo di file multimediale (audio, video), la velocità di riproduzione e la durata dello streaming. Questi campi verranno visualizzati nei registri in tempo reale solo se inviati a. CloudFront
-
timestampData e ora in cui il server edge ha terminato di rispondere alla richiesta.
-
c-ipL'indirizzo IP del visualizzatore che ha effettuato la richiesta, ad esempio,
192.0.2.183o2001:0db8:85a3::8a2e:0370:7334. Se il visualizzatore ha utilizzato un proxy HTTP o un sistema di bilanciamento del carico (load balancer) per inviare la richiesta, il valore di questo campo è l'indirizzo IP del proxy o del sistema di bilanciamento (load balancer) del carico. Vedere anche il campox-forwarded-for. -
s-ipL'indirizzo IP del CloudFront server che ha fornito la richiesta, ad esempio,
192.0.2.183o2001:0db8:85a3::8a2e:0370:7334. -
time-to-first-byteIl numero di secondi tra la ricezione della richiesta e la scrittura del primo byte della risposta, misurato sul server.
-
sc-statusIl codice di stato HTTP della risposta del server (ad esempio,
200). -
sc-bytesIl numero totale di byte che il server ha inviato al visualizzatore in risposta alla richiesta, incluse le intestazioni. Per le connessioni WebSocket e gRPC, questo è il numero totale di byte inviati dal server al client tramite la connessione.
-
cs-methodIl metodo di richiesta HTTP ricevuto dal visualizzatore.
-
cs-protocolProtocollo della richiesta del visualizzatore (
http,https,grpcs,wsowss). -
cs-hostIl valore che il visualizzatore ha incluso nell'intestazione
Hostper questa richiesta. Se utilizzi il nome di CloudFront dominio nel tuo oggetto URLs (ad esempio d111111abcdef8.cloudfront.net), questo campo contiene quel nome di dominio. Se utilizzi nomi di dominio alternativi () nell'oggetto (come www.example.comCNAMEs), questo campo contiene il nome di dominio URLs alternativo. -
cs-uri-stemL'intero URL della richiesta, inclusa la stringa di query (se presente), ma senza il nome di dominio. Ad esempio
/images/cat.jpg?mobile=true.Nota
Nei log standard, il valore
cs-uri-stemnon include la stringa di query. -
cs-bytesNumero totale di byte di dati che il visualizzatore ha incluso nella richiesta, incluse le intestazioni. Per le connessioni WebSocket e gRPC, questo è il numero totale di byte inviati dal client al server sulla connessione.
-
x-edge-locationLa edge location che ha servito la richiesta. Ogni edge location è identificata da un codice di tre lettere e da un numero assegnato arbitrariamente (ad esempio,). DFW3 Il codice di tre lettere di solito corrisponde al codice aeroportuale della IATA (International Air Transport Association) per l'aeroporto vicino alla posizione geografica della posizione edge. (Queste abbreviazioni potrebbero cambiare in futuro).
-
x-edge-request-idUna stringa opaca che identifica in modo univoco una richiesta. CloudFront invia anche questa stringa nell'intestazione della
x-amz-cf-idrisposta. -
x-host-headerIl nome di dominio della CloudFront distribuzione (ad esempio, d111111abcdef8.cloudfront.net).
-
time-takenIl numero di secondi (al millesimo di secondo, ad esempio 0,082) da quando il server riceve la richiesta del visualizzatore a quando il server scrive l'ultimo byte della risposta alla coda di output, misurato sul server. Dal punto di vista del visualizzatore, il tempo totale per ottenere l'oggetto sarà maggiore di questo valore a causa della latenza di rete e del buffering TCP.
-
cs-protocol-versionLa versione HTTP che il visualizzatore ha specificato nella richiesta. I valori possibili sono
HTTP/0.9,HTTP/1.0,HTTP/1.1,HTTP/2.0eHTTP/3.0. -
c-ip-versionLa versione IPv6 IP della richiesta (IPv4 o).
-
cs-user-agentIl valore dell'intestazione
User-Agentnella richiesta. L'intestazioneUser-Agentidentifica l'origine della richiesta, ad esempio il tipo di dispositivo e browser che ha inviato la richiesta e, se la richiesta proveniva da un motore di ricerca, il motore di ricerca. -
cs-refererIl valore dell'intestazione
Referernella richiesta. Questo è il nome del dominio all'origine della richiesta. I referrer comuni includono motori di ricerca, altri siti Web con collegamenti diretti ai tuoi oggetti e il tuo sito Web. -
cs-cookieL'intestazione
Cookienella richiesta, incluse le coppie nome-valore e gli attributi associati.Nota
Questo campo viene troncato a 800 byte.
-
cs-uri-queryL'eventuale parte della stringa di query nell'URL.
-
x-edge-response-result-typeIl modo in cui il server edge ha classificato la risposta appena prima di restituire la risposta al visualizzatore. Vedere anche il campo
x-edge-result-type. I valori possibili includono:-
Hit– Il server ha servito l'oggetto al visualizzatore dalla cache. -
RefreshHit– Il server ha trovato l'oggetto nella cache, ma l'oggetto era scaduto, pertanto il server ha contattato l'origine per verificare che la cache disponesse della versione più recente dell'oggetto. -
Miss– La richiesta non poteva essere soddisfatta da un oggetto nella cache, per cui il server ha inoltrato la richiesta al server di origine e ha restituito il risultato al visualizzatore. -
LimitExceeded— La richiesta è stata rifiutata perché è stata superata una CloudFront quota (precedentemente denominata limite). -
CapacityExceeded: il server ha restituito un errore 503 in quanto non disponeva di capacità sufficiente al momento della richiesta per servire l'oggetto. -
Error– In genere, ciò significa che la richiesta ha provocato un errore client (il valore del camposc-statusè compreso nell'intervallo4xx) o un errore del server (il valore del camposc-statusè nell'intervallo5xx).Se il valore del campo
x-edge-result-typeèErrore il valore di questo campo non èError, il client è stato disconnesso prima del completamento del download. -
Redirect– Il server ha reindirizzato il visualizzatore da HTTP a HTTPS in base alle impostazioni di distribuzione.
-
-
x-forwarded-forSe il visualizzatore ha utilizzato un proxy HTTP o un sistema di bilanciamento del carico (load balancer) per inviare la richiesta, il valore di questo campo
c-ipè l'indirizzo IP del proxy o del sistema di bilanciamento (load balancer) del carico. In tal caso, questo campo è l'indirizzo IP del visualizzatore all'origine della richiesta. Questo campo può contenere più indirizzi IP separati da virgole. Ogni indirizzo IP può essere un IPv4 indirizzo (ad esempio,192.0.2.183) o un IPv6 indirizzo (ad esempio,).2001:0db8:85a3::8a2e:0370:7334 -
ssl-protocolQuando la richiesta utilizza HTTPS, questo campo contiene i SSL/TLS protocol that the viewer and server negotiated for transmitting the request and response. For a list of possible values, see the supported SSL/TLS protocolli inProtocolli e cifrari supportati tra visualizzatori e CloudFront.
-
ssl-cipherQuando la richiesta utilizzava HTTPS, questo campo contiene i SSL/TLS cipher that the viewer and server negotiated for encrypting the request and response. For a list of possible values, see the supported SSL/TLS codici in. Protocolli e cifrari supportati tra visualizzatori e CloudFront
-
x-edge-result-typeCome il server ha classificato la risposta dopo che l'ultimo byte ha lasciato il server. In alcuni casi, il tipo di risultato può variare tra il momento in cui il server è pronto a inviare la risposta e il momento in cui ha finito di inviare la risposta. Vedere anche il campo
x-edge-response-result-type.Ad esempio, in streaming HTTP, si supponga che il server trovi un segmento del flusso nella cache. In questo scenario, il valore di questo campo sarebbe normalmente
Hit. Tuttavia, se il visualizzatore chiude la connessione prima che il server abbia distribuito l'intero segmento, il tipo di risultato finale, e quindi il valore di questo campo, èError.WebSocket e le connessioni gRPC avranno un valore
Missper questo campo perché il contenuto non è memorizzabile nella cache e viene inviato tramite proxy direttamente all'origine.I valori possibili includono:
-
Hit– Il server ha servito l'oggetto al visualizzatore dalla cache. -
RefreshHit– Il server ha trovato l'oggetto nella cache, ma l'oggetto era scaduto, pertanto il server ha contattato l'origine per verificare che la cache disponesse della versione più recente dell'oggetto. -
Miss– La richiesta non è stata soddisfatta da un oggetto nella cache, per cui il server ha inoltrato la richiesta all’origine e ha restituito il risultato al visualizzatore. -
LimitExceeded— La richiesta è stata rifiutata perché è stata superata una CloudFront quota (precedentemente denominata limite). -
CapacityExceeded: il server ha restituito un codice di stato HTTP 503 in quanto non disponeva di capacità sufficiente al momento della richiesta per servire l'oggetto. -
Error– In genere, ciò significa che la richiesta ha provocato un errore client (il valore del camposc-statusè compreso nell'intervallo4xx) o un errore del server (il valore del camposc-statusè nell'intervallo5xx). Se il valore del camposc-statusè200, o se il valore di questo campo èErrore il valore del campox-edge-response-result-typenon èError, significa che la richiesta HTTP ha avuto esito positivo, ma il client si è disconnesso prima di ricevere tutti i byte. -
Redirect– Il server ha reindirizzato il visualizzatore da HTTP a HTTPS in base alle impostazioni di distribuzione.
-
-
fle-encrypted-fieldsIl numero di campi di crittografia a livello di campo che il server ha crittografato e inoltrato all'origine. CloudFront i server trasmettono la richiesta elaborata all'origine mentre crittografano i dati, quindi questo campo può avere un valore anche se il valore di è un errore.
fle-status -
fle-statusQuando la crittografia a livello di campo è configurata per una distribuzione, questo campo contiene un codice che indica se il corpo della richiesta è stato elaborato correttamente. Quando il server elabora il corpo della richiesta, crittografa valori nei campi specificati e inoltra la richiesta all'origine, il valore di questo campo è
Processed. Il valore dix-edge-result-typein questo caso può ancora indicare un errore lato client o lato server.I valori possibili per questo campo sono:
-
ForwardedByContentType– Il server ha inoltrato la richiesta all'origine senza analisi o crittografia poiché non è stato configurato alcun tipo di contenuto. -
ForwardedByQueryArgs: il server ha inoltrato la richiesta all'origine senza analisi o crittografia in quanto la richiesta contiene un argomento di query che non era nella configurazione per la crittografia a livello di campo. -
ForwardedDueToNoProfile– Il server ha inoltrato la richiesta all'origine senza analisi o crittografia in quanto nessun profilo è stato specificato nella configurazione per la crittografia a livello di campo. -
MalformedContentTypeClientError– Il server ha rifiutato la richiesta e ha restituito un codice di stato HTTP 400 al visualizzatore perché il valore dell'intestazioneContent-Typeera in un formato non valido. -
MalformedInputClientError– Il server ha rifiutato la richiesta e restituito un codice di stato HTTP 400 al visualizzatore poiché il corpo della richiesta non era in un formato valido. -
MalformedQueryArgsClientError– Il server ha rifiutato la richiesta e restituito un codice di stato HTTP 400 al visualizzatore poiché un argomento di query era vuoto o non era in un formato valido. -
RejectedByContentType– Il server ha rifiutato la richiesta e restituito un codice di stato HTTP 400 al visualizzatore poiché nessun tipo di contenuto è stato specificato nella configurazione per la crittografia a livello di campo. -
RejectedByQueryArgs– Il server ha rifiutato la richiesta e restituito un codice di stato HTTP 400 al visualizzatore poiché nessun argomento di query è stato specificato nella configurazione per la crittografia a livello di campo. -
ServerError– Il server di origine ha restituito un errore.
Se la richiesta supera una quota di crittografia a livello di campo (in precedenza definita limite), questo campo contiene uno dei seguenti codici di errore e il server restituisce il codice di stato HTTP 400 al visualizzatore. Per un elenco delle quote correnti della crittografia a livello di campo, consulta Quote della crittografia a livello di campo.
-
FieldLengthLimitClientError– Un campo configurato per essere crittografato quando viene superata la massima lunghezza. -
FieldNumberLimitClientError– Una richiesta che la distribuzione è configurata per crittografare contiene più campi di quelli consentiti. -
RequestLengthLimitClientError– La lunghezza del corpo della richiesta supera la lunghezza massima consentita quando è configurata la crittografia a livello di campo.
-
-
sc-content-typeIl valore dell'intestazione HTTP
Content-Typedella risposta. -
sc-content-lenIl valore dell'intestazione HTTP
Content-Lengthdella risposta. -
sc-range-startQuando la risposta contiene l'intestazione HTTP
Content-Range, questo campo contiene il valore iniziale dell'intervallo. -
sc-range-endQuando la risposta contiene l'intestazione HTTP
Content-Range, questo campo contiene il valore finale dell'intervallo. -
c-portIl numero di porta della richiesta del visualizzatore.
-
x-edge-detailed-result-typeQuesto campo contiene lo stesso valore del campo
x-edge-result-type, tranne nei seguenti casi:-
Quando l'oggetto è stato servito al visualizzatore dal livello Origin Shield, questo campo contiene
OriginShieldHit. -
Quando l'oggetto non era nella CloudFront cache e la risposta è stata generata da una funzione Lambda @Edge di richiesta di origine, questo campo contiene.
MissGeneratedResponse -
Quando il valore del campo
x-edge-result-typeèError, questo campo contiene uno dei seguenti valori con ulteriori informazioni sull'errore:-
AbortedOrigin– Il server ha riscontrato un problema con l'origine. -
ClientCommError– La risposta al visualizzatore è stata interrotta a causa di un problema di comunicazione tra il server edge e il visualizzatore. -
ClientGeoBlocked: la distribuzione è configurata per rifiutare le richieste dalla posizione geografica del visualizzatore. -
ClientHungUpRequest— Il visualizzatore si è arrestato prematuramente durante l'invio della richiesta. -
Error: si è verificato un errore per il quale il tipo di errore non si adatta a nessuna delle altre categorie. Questo tipo di errore può verificarsi quando il server edge serve una risposta di errore dalla cache. -
InvalidRequest– Il server ha ricevuto una richiesta non valida dal visualizzatore. -
InvalidRequestBlocked— L'accesso alla risorsa richiesta è bloccato. -
InvalidRequestCertificate: la distribuzione non corrisponde al certificato SSL/TLS in base al quale è stata stabilita la connessione HTTPS. -
InvalidRequestHeader—-La richiesta conteneva un'intestazione non valida. -
InvalidRequestMethod— La distribuzione non è configurata per gestire il metodo di richiesta HTTP utilizzato. Questo può accadere quando la distribuzione supporta solo le richieste memorizzabili nella cache. -
OriginCommError- La richiesta è scaduta durante la connessione a un'origine o durante la lettura di dati da un'origine. -
OriginConnectError: il server non è riuscito a connettersi all'origine. -
OriginContentRangeLengthError: l'intestazioneContent-Lengthnella risposta dell'origine non corrisponde alla lunghezza dell'intestazioneContent-Range. -
OriginDnsError: il server non è riuscito a risolvere il nome di dominio dell'origine. -
OriginError— L'origine ha restituito una risposta errata. -
OriginHeaderTooBigError- Un'intestazione restituita dall'origine è troppo grande per essere elaborata dal server edge. -
OriginInvalidResponseError— L'origine ha restituito una risposta non valida. -
OriginReadError: il server non è in grado di leggere dall'origine. -
OriginWriteError: il server non è in grado di scrivere sull'origine. -
OriginZeroSizeObjectError— Un oggetto di dimensione zero inviato dall'origine ha generato un errore. -
SlowReaderOriginError— Il visualizzatore ha letto lentamente il messaggio che ha causato l'errore di origine.
-
-
-
c-countryCodice paese che rappresenta la posizione geografica del visualizzatore, determinata dal relativo indirizzo IP. Per un elenco dei codici paese, vedere ISO 3166-1 alpha-2
. -
cs-accept-encodingIl valore dell'intestazione
Accept-Encodingnella richiesta del visualizzatore. -
cs-acceptIl valore dell'intestazione
Acceptnella richiesta del visualizzatore. -
cache-behavior-path-patternIl modello di percorso che identifica il comportamento della cache corrispondente alla richiesta del visualizzatore.
-
cs-headersLe intestazioni HTTP (nomi e valori) nella richiesta del visualizzatore.
Nota
Questo campo viene troncato a 800 byte.
-
cs-header-namesI nomi delle intestazioni HTTP (non dei valori) nella richiesta del visualizzatore.
Nota
Questo campo viene troncato a 800 byte.
-
cs-headers-countIl numero di intestazioni HTTP nella richiesta del visualizzatore.
-
origin-fblIl numero di secondi di latenza del primo byte tra e CloudFront l'origine.
-
origin-lblIl numero di secondi di latenza dell'ultimo byte tra e l'origine. CloudFront
-
asnIl numero di sistema autonomo (ASN) del visualizzatore.
-
primary-distribution-idQuando la distribuzione continua è abilitata, questo ID identifica quale distribuzione è la principale nella distribuzione corrente.
-
primary-distribution-dns-nameQuando la distribuzione continua è abilitata, questo valore mostra il nome di dominio primario correlato alla CloudFront distribuzione corrente (ad esempio, d111111abcdef8.cloudfront.net).
Campi CMCD nei log in tempo reale
Per ulteriori informazioni su questi campi, consultate il documento CTA Specification Web Application Video Ecosystem - Common Media Client
Data CTA-5004. -
cmcd-encoded-bitrateIl bitrate codificato dell'oggetto audio o video richiesto.
-
cmcd-buffer-lengthLa lunghezza del buffer dell'oggetto multimediale richiesto.
-
cmcd-buffer-starvationSe il buffer si è esaurito a un certo punto tra la richiesta precedente e la richiesta dell'oggetto. Ciò può far sì che il player si trovi in una statistica di rebuffering, che può bloccare la riproduzione di video o audio.
-
cmcd-content-idUna stringa univoca che identifica il contenuto corrente.
-
cmcd-object-durationLa durata di riproduzione dell'oggetto richiesto (in millisecondi).
-
cmcd-deadlineScadenza dal momento della richiesta entro cui deve essere disponibile il primo campione di questo oggetto, in modo da evitare uno stato di esecuzione insufficiente del buffer o altri problemi di riproduzione.
-
cmcd-measured-throughputLa velocità effettiva tra client e server, misurata dal client.
-
cmcd-next-object-requestIl percorso relativo del successivo oggetto richiesto.
-
cmcd-next-range-requestSe la richiesta successiva è una richiesta parziale di oggetto, questa stringa indica l'intervallo di byte da richiedere.
-
cmcd-object-typeIl tipo di supporto dell'oggetto corrente richiesto.
-
cmcd-playback-rate1 se in tempo reale, 2 se a doppia velocità, 0 se non è in riproduzione.
-
cmcd-requested-maximum-throughputIl throughput massimo richiesto che il cliente ritiene sufficiente per la consegna degli asset.
-
cmcd-streaming-formatIl formato di streaming che definisce la richiesta corrente.
-
cmcd-session-idUn GUID che identifica la sessione di riproduzione corrente.
-
cmcd-stream-typeToken che identifica la disponibilità del segmento.
v= tutti i segmenti sono disponibili.l= i segmenti diventano disponibili nel tempo. -
cmcd-startupLa chiave viene inclusa senza un valore se l'oggetto è necessario urgentemente durante l'avvio, la ricerca o il ripristino dopo un evento di vuotamento del buffer.
-
cmcd-top-bitrateLa resa in bitrate più elevata che il client può riprodurre.
-
cmcd-versionLa versione di questa specifica utilizzata per interpretare i nomi e i valori delle chiavi definiti. Se questa chiave viene omessa, il client e il server devono interpretare i valori come definiti dalla versione 1.
-
r-hostQuesto campo viene inviato per le richieste di origine e indica il dominio del server di origine utilizzato per servire l'oggetto. In caso di errori, puoi utilizzare questo campo per trovare l'ultima origine tentata, ad esempio:
cd8jhdejh6a.mediapackagev2.us-east-1.amazonaws.com -
sr-reasonQuesto campo fornisce un motivo per cui l'origine è stata selezionata. È vuoto quando una richiesta all'origine principale ha esito positivo.
Se si verifica il failover di origine, il campo conterrà il codice di errore HTTP che ha provocato il failover, ad esempio o.
Failover:403Failover:502In caso di failover di origine, se anche la nuova richiesta fallisce e non sono state configurate pagine di errore personalizzate,r-statusindica la risposta della seconda origine. Tuttavia, se hai configurato pagine di errore personalizzate insieme al failover di origine, queste conterranno la risposta della seconda origine se la richiesta non è riuscita ed è stata invece restituita una pagina di errore personalizzata.Se non si verifica alcun failover di origine ma viene selezionata l'origine della resilienza con riconoscimento della qualità dei contenuti multimediali (MQAR), tale operazione verrà registrata come.
MediaQualityPer ulteriori informazioni, consulta Resilienza attenta alla qualità dei media. -
x-edge-mqcsQuesto campo indica il Media Quality Confidence Score (MQCS) (intervallo: 0 - 100) per i segmenti multimediali CloudFront recuperati nelle intestazioni di risposta CMSD della v2. MediaPackage Questo campo è disponibile per le richieste che corrispondono a un comportamento della cache con un gruppo di origine abilitato per MQAR. CloudFront registra questo campo per i segmenti multimediali che vengono serviti anche dalla sua cache oltre alle richieste di origine. Per ulteriori informazioni, consulta Resilienza attenta alla qualità dei media.
Endpoint (Kinesis Data Streams)
L'endpoint contiene informazioni sui Kinesis Data Streams a cui si desidera inviare i log in tempo reale. Fornisci il Amazon Resource Name (ARN) del flusso di dati.
Per ulteriori informazioni sulla creazione di un Kinesis Data Streams, consulta i seguenti argomenti nella Amazon Kinesis Data Streams Developer Guide.
-
Esegui le operazioni di base di Kinesis Data Streams utilizzando AWS CLI
-
Creazione di uno stream (utilizza il) AWS SDK per Java
Quando si crea un flusso di dati, è necessario specificare il numero di partizioni. Utilizzare le seguenti informazioni per stimare il numero di frammenti necessari.
Per stimare il numero di frammenti per il flusso di dati Kinesis
-
Calcola (o stima) il numero di richieste al secondo ricevute dalla distribuzione CloudFront.
Puoi utilizzare i report CloudFront sull'utilizzo
(nella CloudFront console) e le CloudFront metriche (nelle CloudWatch console CloudFront e Amazon) per aiutarti a calcolare le tue richieste al secondo. -
Determina la dimensione tipica di un singolo record di log in tempo reale.
In generale, un singolo record di log è di circa 500 byte. Un record di grandi dimensioni che include tutti i campi disponibili è generalmente di circa 1 KB.
Se non sei sicuro di quale sia la dimensione del record di log, puoi abilitare i log in tempo reale con una bassa frequenza di campionamento (ad esempio, 1%), quindi calcolare la dimensione media del record utilizzando i dati di monitoraggio nei flussi di dati Kinesis (numero totale di byte in ingresso diviso per il numero totale di record).
-
Nella pagina dei prezzi di Amazon Kinesis Data Streams
Calcolatore dei prezzi AWS, sotto, scegli Crea subito il tuo preventivo personalizzato. Nella calcolatrice, inserisci il numero di richieste (record) al secondo.
Immettete la dimensione media dei record di un singolo record di registro.
Scegli Mostra calcoli.
Il calcolatore dei prezzi mostra il numero di frammenti necessari e il costo stimato.
Ruolo IAM
Il ruolo AWS Identity and Access Management (IAM) che consente CloudFront di fornire log in tempo reale al flusso di dati Kinesis.
Quando crei una configurazione di log in tempo reale con la CloudFront console, puoi scegliere Crea nuovo ruolo di servizio per consentire alla console di creare il ruolo IAM per te.
Quando crei una configurazione di log in tempo reale con AWS CloudFormation o l' CloudFront API (AWS CLI o SDK), devi creare tu stesso il ruolo IAM e fornire il ruolo ARN. Per creare autonomamente un ruolo IAM, utilizzare le seguenti policy.
Policy di attendibilità del ruolo IAM
Per utilizzare la seguente policy di fiducia dei ruoli IAM, sostituiscila 111122223333 con il tuo Account AWS
numero. L'Conditionelemento di questa policy aiuta a prevenire il confuso problema del vicesceriffo, in quanto CloudFront può assumere questo ruolo solo per conto di una distribuzione del proprio territorio Account AWS.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "cloudfront.amazonaws.com"
},
"Action": "sts:AssumeRole",
"Condition": {
"StringEquals": {
"aws:SourceAccount": "111122223333"
}
}
}
]
}Policy di autorizzazioni del ruolo IAM per un flusso di dati non crittografato
Per utilizzare la seguente politica, sostituiscila arn:aws:kinesis:us-east-2:123456789012:stream/StreamName con l'ARN del flusso di dati Kinesis.
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kinesis:DescribeStreamSummary",
"kinesis:DescribeStream",
"kinesis:PutRecord",
"kinesis:PutRecords"
],
"Resource": [
"arn:aws:kinesis:us-east-2:123456789012:stream/StreamName"
]
}
]
}Policy di autorizzazioni del ruolo IAM per un flusso di dati crittografato
Per utilizzare la seguente policy, sostituiscila arn:aws:kinesis:us-east-2:123456789012:stream/StreamName con l'ARN del tuo flusso di dati Kinesis e con arn:aws:kms:us-east-2:123456789012:key/e58a3d0b-fe4f-4047-a495-ae03cc73d486 l'ARN del tuo. AWS KMS key
{
"Version": "2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"kinesis:DescribeStreamSummary",
"kinesis:DescribeStream",
"kinesis:PutRecord",
"kinesis:PutRecords"
],
"Resource": [
"arn:aws:kinesis:us-east-2:123456789012:stream/StreamName"
]
},
{
"Effect": "Allow",
"Action": [
"kms:GenerateDataKey"
],
"Resource": [
"arn:aws:kms:us-east-2:123456789012:key/e58a3d0b-fe4f-4047-a495-ae03cc73d486"
]
}
]
}Crea un consumatore Kinesis Data Streams
Per leggere e analizzare i log in tempo reale, si crea o si utilizza un consumer Kinesis Data Streams. Quando crei un consumatore per i log CloudFront in tempo reale, è importante sapere che i campi di ogni record di log in tempo reale vengono sempre forniti nello stesso ordine, come indicato nella sezione. Campi Assicurati di creare il tuo consumatore per soddisfare questo ordine fisso.
Ad esempio, si consideri una configurazione di registro in tempo reale che include solo i tre campi seguenti: time-to-first-byte, sc-status e c-country. In questo scenario, l'ultimo campo, c-country, è sempre il numero di campo 3 in ogni record di registro. Tuttavia, se successivamente si aggiungono campi alla configurazione del registro in tempo reale, il posizionamento di ciascun campo in un record può cambiare.
Ad esempio, se si aggiungono i campi sc-bytes e time-taken alla configurazione del registro in tempo reale, questi campi vengono inseriti in ogni record di registro in base all'ordine mostrato nella sezione Campi. L'ordine risultante di tutti e cinque i campi è time-to-first-byte, sc-status, sc-bytes, time-taken e c-country. Il campo c-country era originariamente il numero 3, ma ora è il campo numero 5. Assicurarsi che l'applicazione consumer sia in grado di gestire i campi che cambiano posizione in un record di registro, nel caso in cui si aggiungono campi alla configurazione del registro in tempo reale.
Risolvi i problemi relativi ai log in tempo reale
Dopo aver creato una configurazione di log in tempo reale, è possibile che non vengano recapitati record (o non tutti i record) a Kinesis Data Streams. In questo caso, è necessario prima verificare che la distribuzione CloudFront stia ricevendo richieste di visualizzatore. In tal caso, è possibile controllare le seguenti impostazioni per continuare la risoluzione dei problemi.
- Autorizzazioni del ruolo IAM
-
Per fornire record di log in tempo reale al flusso di dati Kinesis, CloudFront utilizza il ruolo IAM nella configurazione dei log in tempo reale. Assicurarsi che la policy di attendibilità del ruolo e la policy delle autorizzazioni del ruolo corrispondano alle policy mostrate in Ruolo IAM.
- Throttling di Kinesis Data Streams
-
Se CloudFront scrive record di log in tempo reale nel flusso di dati Kinesis più velocemente di quanto il flusso sia in grado di gestire, Kinesis Data Streams potrebbe limitare le richieste provenienti da. CloudFront In questo caso, è possibile aumentare il numero di frammenti nel flusso di dati Kinesis. Ogni shard può supportare scritture fino a 1.000 record al secondo, fino a un massimo di 1 MB al secondo in scrittura dei dati.
