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à. # Guida introduttiva all'applicazione di esempio Scorekeep **Nota** Avviso di SDK/Daemon manutenzione a raggi X: il 25 febbraio 2026, X-Ray SDKs/Daemon entrerà in modalità di manutenzione, in cui AWS limiterà le versioni di AWS X-Ray SDK e Daemon per risolvere solo problemi di sicurezza. Per ulteriori informazioni sulla tempistica del supporto, consulta. [Cronologia di X-Ray SDK e Daemon Support](xray-sdk-daemon-timeline.md) Ti consigliamo di migrare a. OpenTelemetry Per ulteriori informazioni sulla migrazione a OpenTelemetry, vedere [Migrazione dalla strumentazione a raggi X](https://docs.aws.amazon.com/xray/latest/devguide/xray-sdk-migration.html) alla strumentazione. OpenTelemetry Questo tutorial utilizza il `xray-gettingstarted` ramo dell'[applicazione di esempio Scorekeep](xray-scorekeep.md), che utilizza CloudFormation per creare e configurare le risorse che eseguono l'applicazione di esempio e il demone X-Ray su Amazon ECS. L'applicazione utilizza il framework Spring per implementare un'API Web JSON e AWS SDK per Java per rendere persistenti i dati su Amazon DynamoDB. Un servlet filtra nell'applicazione per tutte le richieste in entrata servite dall'applicazione e un gestore di richieste sugli strumenti client AWS SDK per le chiamate downstream a DynamoDB. Puoi seguire questo tutorial usando il o il. Console di gestione AWS AWS CLI **Topics** + [Prerequisiti](#xray-gettingstarted-prereqs) + [Installa l'applicazione Scorekeep utilizzando CloudFormation](#xray-gettingstarted-deploy) + [Generare i dati di tracciamento](#xray-gettingstarted-generate-traces) + [Visualizza la mappa di tracciamento nel Console di gestione AWS](#xray-gettingstarted-console) + [Configurazione delle notifiche Amazon SNS](#xray-gettingstarted-notifications) + [Esplorare l'applicazione di esempio](#xray-gettingstarted-sample) + [Opzionale: policy con privilegio minimo](#xray-gettingstarted-security) + [Eliminazione](#xray-gettingstarted-cleanup) + [Fasi successive](#xray-gettingstarted-nextsteps) ## Prerequisiti Questo tutorial serve CloudFormation a creare e configurare le risorse che eseguono l'applicazione di esempio e il demone X-Ray. I seguenti prerequisiti sono necessari per l'installazione e l'esecuzione del tutorial: 1. Se utilizzi un utente IAM con autorizzazioni limitate, aggiungi le seguenti politiche utente nella console [IAM](https://console.aws.amazon.com/iam): + `AWSCloudFormationFullAccess`— per accedere e utilizzare CloudFormation + `AmazonS3FullAccess`— per caricare un file modello da CloudFormation utilizzare Console di gestione AWS + `IAMFullAccess`— per creare i ruoli delle istanze Amazon ECS e Amazon EC2 + `AmazonEC2FullAccess`— per creare le risorse Amazon EC2 + `AmazonDynamoDBFullAccess`— per creare le tabelle DynamoDB + `AmazonECS_FullAccess`— per creare risorse Amazon ECS + `AmazonSNSFullAccess`— per creare l'argomento Amazon SNS + `AWSXrayReadOnlyAccess`— per il permesso di visualizzare la mappa di tracciamento e le tracce nella console X-Ray 1. Per eseguire il tutorial utilizzando la AWS CLI, [installa la CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) versione 2.7.9 o successiva e configura [la CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) con l'utente del passaggio precedente. Assicurati che la regione sia configurata durante la configurazione con l'utente. AWS CLI Se una regione non è configurata, sarà necessario aggiungerla `--region AWS-REGION` a ogni comando CLI. 1. Assicurati che [Git](https://github.com/git-guides/install-git) sia installato, per clonare il repository dell'applicazione di esempio. 1. Usa il seguente esempio di codice per clonare il `xray-gettingstarted` ramo del repository Scorekeep: ``` git clone https://github.com/aws-samples/eb-java-scorekeep.git xray-scorekeep -b xray-gettingstarted ``` ## Installa l'applicazione Scorekeep utilizzando CloudFormation ------ #### [ Console di gestione AWS ] **Installa l'applicazione di esempio utilizzando il Console di gestione AWS** 1. Apri la [console CloudFormation](https://console.aws.amazon.com/cloudformation/) 1. Scegli **Crea stack**, quindi scegli **Con nuove risorse** dal menu a discesa. 1. Nella sezione **Specify template**(Specifica il modello) scegliere **Upload a template file** (Carica un file modello). 1. Seleziona **Scegli file**, vai alla `xray-scorekeep/cloudformation` cartella che è stata creata quando hai clonato il repository git e scegli il file. `cf-resources.yaml` 1. Seleziona **Successivo** per continuare. 1. Entra `scorekeep` nella casella di testo **Stack name**, quindi scegli **Avanti** nella parte inferiore della pagina per continuare. Nota che il resto di questo tutorial presuppone che lo stack abbia un nome. `scorekeep` 1. Scorri fino alla fine della pagina **Configura le opzioni dello stack** e scegli **Avanti** per continuare. 1. **Scorri fino alla fine della pagina di **revisione**, seleziona la casella di controllo che riconosce che CloudFormation potrebbe creare risorse IAM con nomi personalizzati e scegli Create stack.** 1. Lo CloudFormation stack è ora in fase di creazione. Lo stato dello stack rimarrà `CREATE_IN_PROGRESS` per circa cinque minuti prima di passare a. `CREATE_COMPLETE` Lo stato verrà aggiornato periodicamente oppure puoi aggiornare la pagina. ------ #### [ AWS CLI ] **Installa l'applicazione di esempio utilizzando AWS CLI** 1. Accedete alla `cloudformation` cartella del `xray-scorekeep` repository che avete clonato in precedenza nel tutorial: ``` cd xray-scorekeep/cloudformation/ ``` 1. Immettete il seguente AWS CLI comando per creare lo stack: CloudFormation ``` aws cloudformation create-stack --stack-name scorekeep --capabilities "CAPABILITY_NAMED_IAM" --template-body file://cf-resources.yaml ``` 1. Attendi che lo stato dello CloudFormation stack sia raggiunto`CREATE_COMPLETE`, operazione che richiederà circa cinque minuti. Usa il seguente AWS CLI comando per controllare lo stato: ``` aws cloudformation describe-stacks --stack-name scorekeep --query "Stacks[0].StackStatus" ``` ------ ## Generare i dati di tracciamento L'applicazione di esempio include un app web di front-end. Utilizza l'app Web per generare traffico verso l'API e inviare dati di traccia a X-Ray. Innanzitutto, recupera l'URL dell'app Web utilizzando Console di gestione AWS o: AWS CLI ------ #### [ Console di gestione AWS ] **Trovate l'URL dell'applicazione utilizzando il Console di gestione AWS** 1. Apri la [console CloudFormation](https://console.aws.amazon.com/cloudformation/) 1. Scegliete lo `scorekeep` stack dall'elenco. 1. Scegli la scheda **Output** nella pagina dello `scorekeep` stack e scegli il link `LoadBalancerUrl` URL per aprire l'applicazione web. ------ #### [ AWS CLI ] **Trovate l'URL dell'applicazione utilizzando il AWS CLI** 1. Utilizzate il seguente comando per visualizzare l'URL dell'applicazione Web: ``` aws cloudformation describe-stacks --stack-name scorekeep --query "Stacks[0].Outputs[0].OutputValue" ``` 1. Copia questo URL e aprilo in un browser per visualizzare l'applicazione web Scorekeep. ------ **Utilizza l'applicazione Web per generare dati di traccia** 1. Scegliere **Create (Crea)** per creare un utente e una sessione. 1. Digitare un **game name (nome del gioco)**, impostare **Rules (Regole)** a **Tic Tac Toe (Tris)** e quindi scegliere **Create (Crea)** per creare un gioco. 1. Scegliere **Play (Gioca)** per iniziare il gioco. 1. Scegliere un riquadro per fare una mossa e modificare lo stato del gioco. Ciascuno di questi passaggi genera richieste HTTP all'API e chiamate downstream a DynamoDB per leggere e scrivere dati relativi a utenti, sessioni, giochi, spostamenti e stati. ## Visualizza la mappa di tracciamento nel Console di gestione AWS È possibile visualizzare la mappa di traccia e le tracce generate dall'applicazione di esempio negli X-Ray e CloudWatch nelle console. ------ #### [ X-Ray console ] **Usa la console X-Ray** 1. Apri la pagina della mappa di tracciamento della console [X-Ray](https://console.aws.amazon.com/xray/home#/service-map). 1. La console mostra una rappresentazione del grafico del servizio generato da X-Ray dai dati di traccia inviati dall'applicazione. Assicurati di modificare il periodo di tempo della mappa di traccia, se necessario, per assicurarti che mostri tutte le tracce dal primo avvio dell'applicazione web. ![\[Periodo temporale della mappa di tracciamento a raggi X\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/xray-console-time-period-15-minutes.png) La mappa di traccia mostra il client dell'app Web, l'API in esecuzione in Amazon ECS e ogni tabella DynamoDB utilizzata dall'applicazione. Ogni richiesta all'applicazione, fino a un numero massimo configurabile di richieste al secondo, viene tracciata non appena viene ricevuta dall'API, genera le richieste verso i servizi a valle e si conclude. Puoi scegliere qualsiasi nodo del grafo del servizio per visualizzare i dati di tracciamento per le richieste che hanno generato il traffico verso tale nodo. Attualmente, il nodo Amazon SNS è giallo. Approfondisci l'esplorazione per scoprire perché. ![\[Pagina della mappa di tracciamento della console X-Ray\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-gettingstarted-servicemap-before-ECS.png) **Per trovare la causa dell'errore** 1. Scegliere il nodo denominato **SNS**. Viene visualizzato il pannello dei dettagli del nodo. 1. Scegliere **View traces (Visualizza tracciamenti)** per accedere alla schermata **Trace overview (Panoramica tracciamenti)**. 1. Scegliere il tracciamento dalla **Trace list (Elenco tracciamenti)**. A questo tracciamento non sono associati metodo o URL perché è stato registrato durante l'avvio anziché in risposta a una richiesta in entrata. ![\[Scegliere un tracciamento dall'elenco dei tracciamenti\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-gettingstarted-tracelist-sns.png) 1. Scegli l'icona dello stato dell'errore all'interno del segmento Amazon SNS nella parte inferiore della pagina per aprire la pagina **Eccezioni** per il sottosegmento SNS. ![\[Scegli l'icona dello stato dell'errore per aprire la pagina Eccezioni per il sottosegmento Amazon SNS\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-gettingstarted-timeline-sns-ecs.png) 1. L'SDK X-Ray acquisisce automaticamente le eccezioni generate dai client AWS SDK strumentati e registra la traccia dello stack. ![\[La scheda Exceptions (Eccezioni) mostra le eccezioni acquisite e memorizza lo stack trace\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-gettingstarted-exception.png) ------ #### [ CloudWatch console ] **Usa la console CloudWatch** 1. Apri la pagina della [mappa di tracciamento X-Ray](https://console.aws.amazon.com/cloudwatch/home#xray:service-map/map) della CloudWatch console. 1. La console mostra una rappresentazione del grafico del servizio generato da X-Ray dai dati di traccia inviati dall'applicazione. Assicurati di modificare il periodo di tempo della mappa di traccia, se necessario, per assicurarti che mostri tutte le tracce dal primo avvio dell'applicazione web. ![\[CloudWatch periodo di tempo della mappa di tracciamento\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/cw-console-service-map-time-period-15-minutes.png) La mappa di traccia mostra il client dell'app Web, l'API in esecuzione in Amazon EC2 e ogni tabella DynamoDB utilizzata dall'applicazione. Ogni richiesta all'applicazione, fino a un numero massimo configurabile di richieste al secondo, viene tracciata non appena viene ricevuta dall'API, genera le richieste verso i servizi a valle e si conclude. Puoi scegliere qualsiasi nodo del grafo del servizio per visualizzare i dati di tracciamento per le richieste che hanno generato il traffico verso tale nodo. Attualmente, il nodo Amazon SNS è arancione. Approfondisci l'esplorazione per scoprire perché. ![\[Pagina della mappa di tracciamento della console X-Ray\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-gettingstarted-cw-servicemap-before-ECS.png) **Per trovare la causa dell'errore** 1. Scegliere il nodo denominato **SNS**. Il pannello dei dettagli del nodo SNS viene visualizzato sotto la mappa. 1. Scegli **Visualizza tracce** per accedere alla pagina **Traces**. 1. Aggiungi la parte inferiore della pagina, scegli la traccia dall'elenco **Tracce**. A questo tracciamento non sono associati metodo o URL perché è stato registrato durante l'avvio anziché in risposta a una richiesta in entrata. ![\[Scegliere un tracciamento dall'elenco dei tracciamenti\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-gettingstarted-cw-tracelist-sns-ecs.png) 1. Scegli il sottosegmento Amazon SNS nella parte inferiore della cronologia dei segmenti e scegli la scheda **Eccezioni** per il sottosegmento SNS per visualizzare i dettagli dell'eccezione. ![\[Visualizza la scheda Eccezioni per il sottosegmento Amazon SNS\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-gettingstarted-cw-timeline-sns-ecs.png) ------ La causa indica che l'indirizzo e-mail fornito in una chiamata a `createSubscription` invocata nella classe `WebConfig` non è valido. Nella prossima sezione, lo risolveremo. ## Configurazione delle notifiche Amazon SNS Scorekeep utilizza Amazon SNS per inviare notifiche quando gli utenti completano una partita. All'avvio, l'applicazione tenta di creare un abbonamento per un indirizzo e-mail definito in un CloudFormation parametro stack. Al momento la chiamata non è riuscita. Configura un'e-mail di notifica per abilitare le notifiche e risolvere gli errori evidenziati nella mappa di traccia. ------ #### [ Console di gestione AWS ] **Per configurare le notifiche di Amazon SNS utilizzando Console di gestione AWS** 1. Apri la [console CloudFormation](https://console.aws.amazon.com/cloudformation/) 1. **Scegli il pulsante di opzione accanto al nome dello `scorekeep` stack nell'elenco, quindi scegli Aggiorna.** 1. Assicurati che sia selezionata **l'opzione Usa modello corrente**, quindi fai clic su **Avanti** nella pagina **Aggiorna stack**. 1. Individuate il parametro **Email** nell'elenco e sostituite il valore predefinito con un indirizzo e-mail valido. ![\[Aggiorna la configurazione dell'e-mail\]](http://docs.aws.amazon.com/it_it/xray/latest/devguide/images/scorekeep-cf-email-update.png) 1. Scorri fino alla parte inferiore della pagina e scegli **Next** (Avanti). 1. Scorri fino alla fine della pagina di **revisione**, seleziona la casella di controllo che conferma che CloudFormation potrebbe creare risorse IAM con nomi personalizzati e scegli **Update** stack. 1. Lo CloudFormation stack è ora in fase di aggiornamento. Lo stato dello stack rimarrà `UPDATE_IN_PROGRESS` per circa cinque minuti prima di passare a. `UPDATE_COMPLETE` Lo stato verrà aggiornato periodicamente oppure puoi aggiornare la pagina. ------ #### [ AWS CLI ] **Per configurare le notifiche di Amazon SNS utilizzando AWS CLI** 1. Accedi alla `xray-scorekeep/cloudformation/` cartella creata in precedenza e apri il `cf-resources.yaml` file in un editor di testo. 1. Trovate il `Default` valore all'interno del parametro **Email** e modificatelo *UPDATE\$1ME* in un indirizzo e-mail valido. ``` Parameters: Email: Type: String Default: UPDATE_ME # <- change to a valid abc@def.xyz email address ``` 1. Dalla `cloudformation` cartella, aggiorna lo CloudFormation stack con il seguente AWS CLI comando: ``` aws cloudformation update-stack --stack-name scorekeep --capabilities "CAPABILITY_NAMED_IAM" --template-body file://cf-resources.yaml ``` 1. Attendi che lo stato dello CloudFormation stack sia `UPDATE_COMPLETE` raggiunto, operazione che richiederà alcuni minuti. Usa il seguente AWS CLI comando per controllare lo stato: ``` aws cloudformation describe-stacks --stack-name scorekeep --query "Stacks[0].StackStatus" ``` ------ Quando l'aggiornamento viene completato, Scorekeep si riavvia e crea una sottoscrizione per l'argomento SNS. Controlla la tua e-mail e conferma che la sottoscrizione per visualizzare gli aggiornamenti al completamento di un gioco. Apri la mappa di tracciamento per verificare che le chiamate a SNS non abbiano più esito negativo. ## Esplorare l'applicazione di esempio L'applicazione di esempio è un'API Web HTTP in Java configurata per utilizzare X-Ray SDK for Java. Quando distribuisci l'applicazione con il CloudFormation modello, crea le tabelle DynamoDB, Amazon ECS Cluster e altri servizi necessari per eseguire Scorekeep su ECS. Un file di definizione delle attività per ECS viene creato tramite. CloudFormation Questo file definisce le immagini dei contenitori utilizzate per attività in un cluster ECS. Queste immagini sono ottenute dall'ECR pubblico ufficiale di X-Ray. L'immagine del contenitore dell'API scorekeep ha l'API compilata con Gradle. L'immagine del contenitore del frontend Scorekeep serve il frontend utilizzando il server proxy nginx. Questo server indirizza le richieste verso percorsi che iniziano con /api verso l'API. Per analizzare le richieste HTTP in ingresso, l'applicazione aggiunge il `TracingFilter` fornito dall'SDK. **Example src/main/java/scorekeep/WebConfig.java - filtro servlet** ``` import javax.servlet.Filter; import [com.amazonaws.xray.javax.servlet.AWSXRayServletFilter](https://docs.aws.amazon.com/xray-sdk-for-java/latest/javadoc/com/amazonaws/xray/javax/servlet/AWSXRayServletFilter.html); ... @Configuration public class WebConfig { @Bean public Filter TracingFilter() { return new AWSXRayServletFilter("Scorekeep"); } ... ``` Questo filtro invia i dati di tracciamento di tutte le richieste in entrata elaborate dall'applicazione, inclusi URL della richiesta, metodo, stato della risposta, ora di inizio e ora di fine. L'applicazione effettua anche chiamate downstream a DynamoDB utilizzando. AWS SDK per Java Per strumentare queste chiamate, l'applicazione utilizza semplicemente i sottomoduli AWS relativi all'SDK come dipendenze e l'X-Ray SDK for Java monitora automaticamente tutti i client SDK. AWS L'applicazione crea il codice sorgente su istanza con `Gradle Docker Image` e il file `Docker` per eseguire il `Scorekeep API Dockerfile` file JAR eseguibile che Gradle genera al suo interno. `ENTRYPOINT` **Example uso di Docker per creare tramite Gradle Docker Image** ``` docker run --rm -v /PATH/TO/SCOREKEEP_REPO/home/gradle/project -w /home/gradle/project gradle:4.3 gradle build ``` **Example PUNTO DI INGRESSO DEL FILE DOCKER** ``` ENTRYPOINT [ "sh", "-c", "java -Dserver.port=5000 -jar scorekeep-api-1.0.0.jar" ] ``` Il file `build.gradle` attiva lo scaricamento dei sottomoduli SDK da Maven durante la compilazione dichiarandoli come dipendenze. **Example build.gradle -- dipendenze** ``` ... dependencies { compile("org.springframework.boot:spring-boot-starter-web") testCompile('org.springframework.boot:spring-boot-starter-test') compile('com.amazonaws:aws-java-sdk-dynamodb') compile("com.amazonaws:aws-xray-recorder-sdk-core") compile("com.amazonaws:aws-xray-recorder-sdk-aws-sdk") compile("com.amazonaws:aws-xray-recorder-sdk-aws-sdk-instrumentor") ... } dependencyManagement { imports { mavenBom("com.amazonaws:aws-java-sdk-bom:1.11.67") mavenBom("com.amazonaws:aws-xray-recorder-sdk-bom:2.11.0") } } ``` I sottomoduli core, AWS SDK e AWS SDK Instrumentor sono tutto ciò che serve per strumentare automaticamente tutte le chiamate downstream effettuate con l'SDK. AWS Per inoltrare i dati grezzi del segmento all'API X-Ray, è necessario il demone X-Ray per ascoltare il traffico sulla porta UDP 2000. *A tal fine, l'applicazione fa funzionare il demone X-Ray in un contenitore distribuito insieme all'applicazione Scorekeep su ECS come contenitore secondario.* Per ulteriori informazioni, consulta l'argomento relativo al [demone X-Ray](xray-daemon.md). **Example Definizione del contenitore X-Ray Daemon in una definizione di attività ECS** ``` ... Resources: ScorekeepTaskDefinition: Type: AWS::ECS::TaskDefinition Properties: ContainerDefinitions: ... - Cpu: '256' Essential: true Image: amazon/aws-xray-daemon MemoryReservation: '128' Name: xray-daemon PortMappings: - ContainerPort: '2000' HostPort: '2000' Protocol: udp ... ``` L'X-Ray SDK for Java fornisce una classe denominata `AWSXRay` che fornisce il registratore globale, `TracingHandler` che puoi usare per strumentare il tuo codice. Puoi configurare la registrazione globale per personalizzare il `AWSXRayServletFilter` che crea i segmenti relativi alle chiamate HTTP in entrata. L'esempio include un blocco statico nella classe `WebConfig` che permette di configurare la registrazione globale con i plug-in e le regole di campionamento. **Example src/main/java/scorekeep/WebConfig.java - registratore** ``` import com.amazonaws.xray.AWSXRay; import com.amazonaws.xray.AWSXRayRecorderBuilder; import com.amazonaws.xray.javax.servlet.AWSXRayServletFilter; import com.amazonaws.xray.plugins.ECSPlugin; import com.amazonaws.xray.plugins.EC2Plugin; import com.amazonaws.xray.strategy.sampling.LocalizedSamplingStrategy; ... @Configuration public class WebConfig { ... static { AWSXRayRecorderBuilder builder = AWSXRayRecorderBuilder.standard().withPlugin(new ECSPlugin()).withPlugin(new EC2Plugin()); URL ruleFile = WebConfig.class.getResource("/sampling-rules.json"); builder.withSamplingStrategy(new LocalizedSamplingStrategy(ruleFile)); AWSXRay.setGlobalRecorder(builder.build()); ... } } ``` Questo esempio usa il compilatore per caricare le regole di campionamento da un file denominato `sampling-rules.json`. Le regole di campionamento determinano la frequenza con cui l'SDK registra i segmenti relativi alle richieste in entrata. **Example src/main/java/resources/sampling-regole.json** ``` { "version": 1, "rules": [ { "description": "Resource creation.", "service_name": "*", "http_method": "POST", "url_path": "/api/*", "fixed_target": 1, "rate": 1.0 }, { "description": "Session polling.", "service_name": "*", "http_method": "GET", "url_path": "/api/session/*", "fixed_target": 0, "rate": 0.05 }, { "description": "Game polling.", "service_name": "*", "http_method": "GET", "url_path": "/api/game/*/*", "fixed_target": 0, "rate": 0.05 }, { "description": "State polling.", "service_name": "*", "http_method": "GET", "url_path": "/api/state/*/*/*", "fixed_target": 0, "rate": 0.05 } ], "default": { "fixed_target": 1, "rate": 0.1 } } ``` Le regole di campionamento definiscono quattro regole di campionamento personalizzate e la regola di default. Per ogni richiesta in entrata, l'SDK valuta le regole nell'ordine in cui sono definite. L'SDK si applica la prima regola che corrisponde al metodo, al percorso e al nome del servizio della richiesta. Per Scorekeep, la prima regola cattura tutte le richieste POST (chiamate di creazione delle risorse) applicando un obiettivo fisso di una richiesta al secondo e una percentuale di 1,0, o il 100%, delle richieste dopo il raggiungimento dell'obiettivo fisso. Le altre tre regole personalizzate applicano una percentuale del 5% delle chiamate, senza alcun obiettivo fisso per sessioni, giochi e letture dello stato (richieste GET). Questo riduce al minimo il numero di tracciamenti per le chiamate periodiche che il front-end invoca automaticamente ogni pochi secondi per garantire l'aggiornamento del contenuto. Per tutte le altre richieste, il file definisce un obiettivo di default di una richiesta al secondo e una percentuale del 10% delle chiamate successive. L'applicazione di esempio mostra anche come utilizzare le funzionalità avanzate come l'analisi manuale del client SDK, la creazione di sottosegmenti aggiuntivi e le chiamate HTTP in uscita. Per ulteriori informazioni, consulta [AWS X-Ray applicazione di esempio](xray-scorekeep.md). ## Opzionale: policy con privilegio minimo I contenitori Scorekeep ECS accedono alle risorse utilizzando politiche di accesso completo, come e. `AmazonSNSFullAccess` `AmazonDynamoDBFullAccess` L'utilizzo di politiche di accesso completo non è la migliore pratica per le applicazioni di produzione. L'esempio seguente aggiorna la policy IAM di DynamoDB per migliorare la sicurezza dell'applicazione. Per saperne di più sulle best practice di sicurezza nelle policy IAM, consulta [Identity and access management for AWS X-Ray](security-iam.md). **Example Modello cf-resources.yaml Definizione del ruolo ECSTask** ``` ECSTaskRole: Type: AWS::IAM::Role Properties: AssumeRolePolicyDocument: Version: "2012-10-17" Statement: - Effect: "Allow" Principal: Service: - "ecs-tasks.amazonaws.com" Action: - "sts:AssumeRole" ManagedPolicyArns: - "arn:aws:iam::aws:policy/AmazonDynamoDBFullAccess" - "arn:aws:iam::aws:policy/AmazonSNSFullAccess" - "arn:aws:iam::aws:policy/AWSXrayFullAccess" RoleName: "scorekeepRole" ``` Per aggiornare la policy, è necessario innanzitutto identificare l'ARN delle risorse DynamoDB. Quindi si utilizza l'ARN in una policy IAM personalizzata. Infine, applichi tale policy al profilo della tua istanza. **Per identificare l'ARN della tua risorsa DynamoDB:** 1. Aprire la [console DynamoDB](https://console.aws.amazon.com/dynamodbv2). 1. Scegli **Tabelle dalla barra** di navigazione a sinistra. 1. Scegli una delle opzioni `scorekeep-*` per visualizzare la pagina dei dettagli della tabella. 1. Nella scheda **Panoramica**, scegli **Informazioni aggiuntive** per espandere la sezione e visualizzare Amazon Resource Name (ARN). Copia questo valore. 1. Inserisci l'ARN nella seguente politica IAM, sostituendo `AWS_ACCOUNT_ID` i valori `AWS_REGION` and con la regione e l'ID dell'account specifici. Questa nuova politica consente solo le azioni specificate, anziché la `AmazonDynamoDBFullAccess` politica che consente qualsiasi azione. **Example** ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "ScorekeepDynamoDB", "Effect": "Allow", "Action": [ "dynamodb:PutItem", "dynamodb:UpdateItem", "dynamodb:DeleteItem", "dynamodb:GetItem", "dynamodb:Scan", "dynamodb:Query" ], "Resource": "arn:aws:dynamodb:us-east-1:111122223333:table/scorekeep-*" } ] } ``` ------ Le tabelle create dall'applicazione seguono una convenzione di denominazione coerente. È possibile utilizzare il `scorekeep-*` formato per indicare tutte le tabelle Scorekeep. **Cambia la tua politica IAM** 1. Apri il [ruolo dell'attività Scorekeep (ScorekeepRole) dalla console IAM.](https://console.aws.amazon.com/iamv2/home#/roles/details/scorekeepRole) 1. **Seleziona la casella di controllo accanto alla `AmazonDynamoDBFullAccess` politica e scegli Rimuovi per rimuovere questa politica.** 1. Scegli **Aggiungi autorizzazioni**, quindi **Allega politiche** e infine **Crea politica**. 1. Scegli la scheda **JSON** e incolla la politica creata sopra. 1. Scegli **Avanti: Tag** nella parte inferiore della pagina. 1. Scegli **Avanti: revisione** nella parte inferiore della pagina. 1. Per **Nome**, assegna un nome alla politica. 1. Scegli **Crea politica** nella parte inferiore della pagina. 1. Allega la politica appena creata al `scorekeepRole` ruolo. Potrebbero essere necessari alcuni minuti prima che la policy allegata abbia effetto. Se hai allegato la nuova policy al `scorekeepRole` ruolo, devi scollegarla prima di eliminare lo CloudFormation stack, poiché questa politica allegata bloccherà l'eliminazione dello stack. La policy può essere rimossa automaticamente eliminando la policy. **Rimuovi la tua policy IAM personalizzata** 1. Apri la [console IAM](https://console.aws.amazon.com/iam). 1. Scegli **Policies** dalla barra di navigazione a sinistra. 1. Cerca il nome della politica personalizzata che hai creato in precedenza in questa sezione e scegli il pulsante di opzione accanto al nome della politica per evidenziarlo. 1. **Scegli il menu a discesa **Azioni**, quindi scegli Elimina.** 1. Digita il nome della politica personalizzata, quindi scegli **Elimina per confermare l'eliminazione**. Ciò scollegherà automaticamente la politica dal `scorekeepRole` ruolo. ## Eliminazione Segui questi passaggi per eliminare le risorse dell'applicazione Scorekeep: **Nota** Se hai creato e allegato politiche personalizzate utilizzando la sezione precedente di questo tutorial, devi rimuovere la politica `scorekeepRole` prima di eliminare lo stack. CloudFormation ------ #### [ Console di gestione AWS ] **Eliminare l'applicazione di esempio utilizzando il Console di gestione AWS** 1. Apri la [console CloudFormation](https://console.aws.amazon.com/cloudformation/) 1. Scegliete il pulsante di opzione accanto al nome `scorekeep` dello stack nell'elenco, quindi scegliete **Elimina**. 1. Lo CloudFormation stack viene ora eliminato. Lo stato dello stack rimarrà valido `DELETE_IN_PROGRESS` per alcuni minuti fino all'eliminazione di tutte le risorse. Lo stato verrà aggiornato periodicamente oppure puoi aggiornare la pagina. ------ #### [ AWS CLI ] **Eliminare l'applicazione di esempio utilizzando il AWS CLI** 1. Immettete il seguente AWS CLI comando per eliminare lo CloudFormation stack: ``` aws cloudformation delete-stack --stack-name scorekeep ``` 1. Attendi che lo CloudFormation stack non esista più, l'operazione richiederà circa cinque minuti. Usa il seguente AWS CLI comando per controllare lo stato: ``` aws cloudformation describe-stacks --stack-name scorekeep --query "Stacks[0].StackStatus" ``` ------ ## Fasi successive Scopri di più su X-Ray nel prossimo capitolo,. [AWS X-Ray concetti](xray-concepts.md) Per strumentare la tua app, scopri di più sull'X-Ray SDK for Java o su uno degli altri X-Ray: SDKs + **X-Ray SDK** per Java — [AWS X-Ray SDK per Java](xray-sdk-java.md) + **X-Ray SDK** per Node.js — [AWS X-Ray SDK per Node.js](xray-sdk-nodejs.md) + **X-Ray SDK** per.NET — [AWS X-Ray SDK per.NET](xray-sdk-dotnet.md) Per eseguire il demone X-Ray localmente o su, vedere. AWS[AWS X-Ray demone](xray-daemon.md) Per contribuire all'applicazione di esempio su GitHub, vedere. [eb-java-scorekeep](https://github.com/awslabs/eb-java-scorekeep/tree/xray-gettingstarted)