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à. # Abilitazione di Transaction Search Puoi abilitare [Transaction Search](CloudWatch-Transaction-Search.md) utilizzando la console o l'API. [La ricerca delle transazioni è configurata per l'intero account e trasforma l'inserimento di tutti gli intervalli tramite X-Ray in una modalità di raccolta conveniente utilizzando Amazon Pricing. CloudWatch ](https://aws.amazon.com/cloudwatch/pricing/) Per impostazione predefinita, indicizzerai gratuitamente anche l'1% degli intervalli inseriti come riepilogo delle tracce per l'analisi, il che in genere è sufficiente dato che hai già una visibilità completa delle end-to-end tracce su tutti gli intervalli importati tramite Transaction Search. ## Prerequisiti Prima di abilitare Transaction Search, è necessario creare un ruolo con le seguenti autorizzazioni. ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayPermissions", "Effect": "Allow", "Action": [ "xray:GetTraceSegmentDestination", "xray:UpdateTraceSegmentDestination", "xray:GetIndexingRules", "xray:UpdateIndexingRule" ], "Resource": "*" }, { "Sid": "TransactionSearchLogGroupPermissions", "Effect": "Allow", "Action": [ "logs:CreateLogGroup", "logs:CreateLogStream", "logs:PutRetentionPolicy" ], "Resource": [ "arn:aws:logs:*:*:log-group:/aws/application-signals/data:*", "arn:aws:logs:*:*:log-group:aws/spans:*" ] }, { "Sid": "TransactionSearchLogsPermissions", "Effect": "Allow", "Action": [ "logs:PutResourcePolicy", "logs:DescribeResourcePolicies" ], "Resource": "*" }, { "Sid": "TransactionSearchApplicationSignalsPermissions", "Effect": "Allow", "Action": [ "application-signals:StartDiscovery" ], "Resource": "*" }, { "Sid": "CloudWatchApplicationSignalsCreateServiceLinkedRolePermissions", "Effect": "Allow", "Action": "iam:CreateServiceLinkedRole", "Resource": "arn:aws:iam::*:role/aws-service-role/application-signals.cloudwatch.amazonaws.com/AWSServiceRoleForCloudWatchApplicationSignals", "Condition": { "StringLike": { "iam:AWSServiceName": "application-signals.cloudwatch.amazonaws.com" } } }, { "Sid": "CloudWatchApplicationSignalsGetRolePermissions", "Effect": "Allow", "Action": "iam:GetRole", "Resource": "arn:aws:iam::*:role/aws-service-role/application-signals.cloudwatch.amazonaws.com/AWSServiceRoleForCloudWatchApplicationSignals" }, { "Sid": "CloudWatchApplicationSignalsCloudTrailPermissions", "Effect": "Allow", "Action": [ "cloudtrail:CreateServiceLinkedChannel" ], "Resource": "arn:aws:cloudtrail:*:*:channel/aws-service-channel/application-signals/*" } ] } ``` ------ **Nota** [Per utilizzare Transaction Search e altre CloudWatch funzionalità, aggiungi la policy al tuo ruolo. CloudWatchReadOnlyAccess ](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/CloudWatchReadOnlyAccess.html) Per ulteriori informazioni sulla creazione di un ruolo, consulta [IAM role creation](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create.html). ## Abilitazione di Transaction Search nella console La procedura seguente descrive come abilitare Transaction Search nella console. **Per abilitare Transaction Search nella CloudWatch console** 1. Apri la CloudWatch console all'indirizzo [https://console.aws.amazon.com/cloudwatch/](https://console.aws.amazon.com/cloudwatch/). 1. Dal pannello di navigazione, in **Application Signals**, scegli **Transaction Search**. 1. Scegli **Abilita Transaction Search** 1. Seleziona la casella per importare gli intervalli come log strutturati e inserisci una percentuale di intervalli da indicizzare. Puoi indicizzare gli intervalli all'1% gratuitamente e modificare la percentuale in un secondo momento in base alle tue esigenze. ## Abilitazione di Transaction Search tramite un'API La procedura seguente descrive come abilitare Transaction Search utilizzando un'API. ### Passaggio 1. Crea una politica che garantisca l'accesso agli intervalli di acquisizione nei registri CloudWatch Quando si utilizza l'SDK AWS CLI o per abilitare Transaction Search, è necessario configurare le autorizzazioni utilizzando una politica basata sulle risorse con. [https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html](https://docs.aws.amazon.com/xray/latest/api/API_PutResourcePolicy.html) **Policy di esempio** La seguente policy di esempio consente a X-Ray di inviare tracce a Logs CloudWatch ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:aws:logs:us-east-1:123456789012:log-group:aws/spans:*", "arn:aws:logs:us-east-1:123456789012:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:aws:xray:us-east-1:123456789012:*" }, "StringEquals": { "aws:SourceAccount": "123456789012" } } } ] } ``` ------ **Esempio di comando** L'esempio seguente mostra come formattare il AWS CLI comando con. `PutResourcePolicy` ``` aws logs put-resource-policy --policy-name MyResourcePolicy --policy-document '{ "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:partition:logs:region:account-id:log-group:aws/spans:*", "arn:partition:logs:region:account-id:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:partition:xray:region:account-id:*" }, "StringEquals": { "aws:SourceAccount": "account-id" } } } ]}' ``` ### Passaggio 2. Configurazione della destinazione dei segmenti di traccia Configura l'importazione degli intervalli con [https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateTraceSegmentDestination.html). **Esempio di comando** L'esempio seguente mostra come formattare il AWS CLI comando con`UpdateTraceSegmentDestination`. ``` aws xray update-trace-segment-destination --destination CloudWatchLogs ``` ### Fase 3. Configurazione della quantità di intervalli da indicizzare Configura la percentuale di campionamento desiderata con [https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html](https://docs.aws.amazon.com/xray/latest/api/API_UpdateIndexingRule.html) **Esempio di comando** L'esempio seguente mostra come formattare il AWS CLI comando con`UpdateIndexingRule`. ``` aws xray update-indexing-rule --name "Default" --rule '{"Probabilistic": {"DesiredSamplingPercentage": number}}' ``` **Nota** Dopo aver abilitato Transaction Search, potrebbero essere necessari fino a dieci minuti prima che gli intervalli risultino disponibili per la ricerca e l'analisi. ### Passaggio 4. Verifica della disponibilità a fini di ricerca e analisi degli intervalli Per verificare che gli intervalli siano disponibili per la ricerca e l'analisi, utilizza [https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html](https://docs.aws.amazon.com/xray/latest/api/API_GetTraceSegmentDestination.html). **Comandi di esempio** L'esempio seguente mostra come formattare il AWS CLI comando con`GetTraceSegmentDestination`. ``` aws xray get-trace-segment-destination ``` **Esempio di risposta** L'esempio seguente mostra la risposta che ci si può aspettare quando Transaction Search è attiva. ``` { "Destination": "CloudWatchLogs", "Status": "ACTIVE" } ``` # Utilizzo della ricerca delle transazioni con CloudFormation È possibile utilizzare CloudFormation per abilitare e configurare X-Ray Transaction Search. **Nota** Per creare uno CloudFormation stack, vedi [Creazione del tuo primo](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/gettingstarted.walkthrough.html) stack. ## Prerequisiti + Devi avere accesso a un AWS account con un utente o un ruolo IAM che disponga delle autorizzazioni per utilizzare Amazon EC2 CloudFormation, Amazon S3 o disporre dell'accesso come utente amministrativo. + Devi disporre di un cloud privato virtuale (VPC) con accesso a Internet. Per semplificare le cose, puoi utilizzare il VPC predefinito fornito con il tuo account. Il VPC e le sottoreti predefiniti sono sufficienti per questa configurazione. + Assicurati che Transaction Search sia disabilitato prima di abilitare l'utilizzo di or. AWS CDK CloudFormation ## Abilitazione di Transaction Search Per abilitare l'utilizzo di Transaction Search CloudFormation, è necessario creare le due risorse seguenti. + `AWS::Logs::ResourcePolicy` + `AWS::XRay::TransactionSearchConfig` 1. **Crea AWS::Logs::ResourcePolicy**: crea una politica delle risorse che consenta a X-Ray di inviare tracce ai registri CloudWatch **YAML** ``` Resources: LogsResourcePolicy: Type: AWS::Logs::ResourcePolicy Properties: PolicyName: TransactionSearchAccess PolicyDocument: !Sub > { "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:aws/spans:*", "arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:${AWS::Partition}:xray:${AWS::Region}:${AWS::AccountId}:*" }, "StringEquals": { "aws:SourceAccount": "${AWS::AccountId}" } } } ] } ``` **JSON** ``` { "Resources": { "LogsResourcePolicy": { "Type": "AWS::Logs::ResourcePolicy", "Properties": { "PolicyName": "TransactionSearchAccess", "PolicyDocument": { "Fn::Sub": "{\n \"Version\": \"2012-10-17\", \n \"Statement\": [\n {\n \"Sid\": \"TransactionSearchXRayAccess\",\n \"Effect\": \"Allow\",\n \"Principal\": {\n \"Service\": \"xray.amazonaws.com\"\n },\n \"Action\": \"logs:PutLogEvents\",\n \"Resource\": [\n \"arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:aws/spans:*\",\n \"arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:/aws/application-signals/data:*\"\n ],\n \"Condition\": {\n \"ArnLike\": {\n \"aws:SourceArn\": \"arn:${AWS::Partition}:xray:${AWS::Region}:${AWS::AccountId}:*\"\n },\n \"StringEquals\": {\n \"aws:SourceAccount\": \"${AWS::AccountId}\"\n }\n }\n }\n ]\n}" } } } } } ``` 1. **Crea e configura AWS::XRay::TransactionSearchConfig**: crea la `TransactionSearchConfig` risorsa per abilitare la ricerca delle transazioni. **YAML** ``` Resources: XRayTransactionSearchConfig: Type: AWS::XRay::TransactionSearchConfig ``` **JSON** ``` { "Resources": { "XRayTransactionSearchConfig": { "Type": "AWS::XRay::TransactionSearchConfig" } } } ``` 1. (Facoltativo) Puoi impostare la proprietà `IndexingPercentage` per controllare la percentuale di intervalli che verranno indicizzati. **YAML** ``` Resources: XRayTransactionSearchConfig: Type: AWS::XRay::TransactionSearchConfig Properties: IndexingPercentage: 50 ``` **JSON** ``` { "Resources": { "XRayTransactionSearchConfig": { "Type": "AWS::XRay::TransactionSearchConfig", "Properties": { "IndexingPercentage": 20 } } } } ``` Il IndexingPercentage valore può essere impostato tra 0 e 100. ## Esempi di modello L'esempio seguente include sia la politica delle risorse che la TransactionSearchConfig. **YAML** ``` Resources: LogsResourcePolicy: Type: AWS::Logs::ResourcePolicy Properties: PolicyName: TransactionSearchAccess PolicyDocument: !Sub > { "Version": "2012-10-17", "Statement": [ { "Sid": "TransactionSearchXRayAccess", "Effect": "Allow", "Principal": { "Service": "xray.amazonaws.com" }, "Action": "logs:PutLogEvents", "Resource": [ "arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:aws/spans:*", "arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:/aws/application-signals/data:*" ], "Condition": { "ArnLike": { "aws:SourceArn": "arn:${AWS::Partition}:xray:${AWS::Region}:${AWS::AccountId}:*" }, "StringEquals": { "aws:SourceAccount": "${AWS::AccountId}" } } } ] } XRayTransactionSearchConfig: Type: AWS::XRay::TransactionSearchConfig Properties: IndexingPercentage: 10 ``` **JSON** ``` { "Resources": { "LogsResourcePolicy": { "Type": "AWS::Logs::ResourcePolicy", "Properties": { "PolicyName": "TransactionSearchAccess", "PolicyDocument": { "Fn::Sub": "{\n \"Version\": \"2012-10-17\", \n \"Statement\": [\n {\n \"Sid\": \"TransactionSearchXRayAccess\",\n \"Effect\": \"Allow\",\n \"Principal\": {\n \"Service\": \"xray.amazonaws.com\"\n },\n \"Action\": \"logs:PutLogEvents\",\n \"Resource\": [\n \"arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:aws/spans:*\",\n \"arn:${AWS::Partition}:logs:${AWS::Region}:${AWS::AccountId}:log-group:/aws/application-signals/data:*\"\n ],\n \"Condition\": {\n \"ArnLike\": {\n \"aws:SourceArn\": \"arn:${AWS::Partition}:xray:${AWS::Region}:${AWS::AccountId}:*\"\n },\n \"StringEquals\": {\n \"aws:SourceAccount\": \"${AWS::AccountId}\"\n }\n }\n }\n ]\n}" } } }, "XRayTransactionSearchConfig": { "Type": "AWS::XRay::TransactionSearchConfig", "Properties": { "IndexingPercentage": 20 } } } } ``` Ecco un esempio di utilizzo di AWS CDK in TypeScript. **CDK** ``` import * as cdk from '@aws-cdk/core'; import * as logs from '@aws-cdk/aws-logs'; import * as xray from '@aws-cdk/aws-xray'; export class XRayTransactionSearchStack extends cdk.Stack { constructor(scope: cdk.Construct, id: string, props?: cdk.StackProps) { super(scope, id, props); // Create the resource policy const transactionSearchAccess = new logs.CfnResourcePolicy(this, 'XRayLogResourcePolicy', { policyName: 'TransactionSearchAccess', policyDocument: JSON.stringify({ Version: '2012-10-17', Statement: [ { Sid: 'TransactionSearchXRayAccess', Effect: 'Allow', Principal: { Service: 'xray.amazonaws.com', }, Action: 'logs:PutLogEvents', Resource: [ `arn:${this.partition}:logs:${this.region}:${this.account}:log-group:aws/spans:*`, `arn:${this.partition}:logs:${this.region}:${this.account}:log-group:/aws/application-signals/data:*`, ], Condition: { ArnLike: { 'aws:SourceArn': `arn:${this.partition}:xray:${this.region}:${this.account}:*`, }, StringEquals: { 'aws:SourceAccount': this.account, }, }, }, ], }), }); // Create the TransactionSearchConfig with dependency const transactionSearchConfig = new xray.CfnTransactionSearchConfig(this, 'XRayTransactionSearchConfig', { indexingPercentage: 10, }); // Add the dependency to ensure Resource Policy is created first transactionSearchConfig.addDependsOn(transactionSearchAccess); } } ``` ## Verifica della configurazione Dopo aver distribuito lo CloudFormation stack, puoi verificare la configurazione utilizzando. AWS CLI **aws xray get-trace-segment-destination** Una configurazione corretta restituirà quanto segue. ``` { "Destination": "CloudWatchLogs", "Status": "ACTIVE" } ```