Removed AWSGlobal class and added ReadMe

Author: carolabadeer

src/Instrumentation/AwsSdk/AwsSdkInstrumentation.php

@@ -30,8 +30,8 @@ class AwsSdkInstrumentation implements InstrumentationInterface
     private TextMapPropagatorInterface $propagator;
     private TracerProviderInterface $tracerProvider;
     private $clients = [] ;
-    private String $clientName;
-    private String $region;
+    private string $clientName = 'awsClient';
+    private string $region;
     private SpanInterface $span;
     private ScopeInterface $scope;
 
@@ -80,16 +80,12 @@ public function getTracer(): TracerInterface
         return $this->tracerProvider->getTracer('io.opentelemetry.contrib.php');
     }
 
-    public function getContext():Context
-    {
-        return Context::getRoot();
-    }
-
     public function instrumentClients($clientsArray) : void
     {
         $this->clients = $clientsArray;
     }
 
+    /** @psalm-suppress ArgumentTypeCoercion */
     public function activate(): bool
     {
         try {
@@ -98,11 +94,11 @@ public function activate(): bool
                 $propagator = $this->getPropagator();
 
                 $carrier = [];
-
-                $this->span = $tracer->spanBuilder($this->clientName . '.' . $cmd->getName())->setSpanKind(AwsSdkInstrumentation::SPAN_KIND)->startSpan();
+                /** @phan-suppress-next-line PhanTypeMismatchArgument */
+                $this->span = $tracer->spanBuilder($this->clientName)->setSpanKind(AwsSdkInstrumentation::SPAN_KIND)->startSpan();
                 $this->scope = $this->span->activate();
 
-                $propagator->inject($carrier, null, $this->getContext());
+                $propagator->inject($carrier);
 
                 $this->span->setAttributes([
                     'rpc.method' => $cmd->getName(),

src/Instrumentation/AwsSdk/README.md

@@ -0,0 +1,50 @@
+# AWS SDK Instrumentation for OpenTelemetry PHP 
+This package supports manual instrumentation for the AWS SDK for PHP. For more information on how to use the AWS SDK, see the [AWS SDK for PHP Developer's Guide](https://docs.aws.amazon.com/sdk-for-php/v3/developer-guide/welcome.html). 
+
+
+## Using the AWS SDK Instrumentation with AWS X-Ray
+
+
+```
+use OpenTelemetry\Instrumentation\AwsSdk\AwsSdkInstrumentation;
+
+// Initialize Span Processor, X-Ray ID generator, Tracer Provider, and Propagator
+$spanProcessor = new SimpleSpanProcessor(new OTLPExporter());
+$xrayIdGenerator = new IdGenerator();
+$tracerProvider = new TracerProvider($spanProcessor, null, null, null, $xrayIdGenerator);
+$xrayPropagator = new Propagator();
+
+// Create new instance of AWS SDK Instrumentation class
+$awssdkinstrumentation = new  AwsSdkInstrumentation();
+
+// Configure AWS SDK Instrumentation with Propagator and set Tracer Provider (created above)
+$awssdkinstrumentation->setPropagator($xrayPropagator);
+$awssdkinstrumentation->setTracerProvider($tracerProvider);
+
+// Create and activate root span
+$root = $awssdkinstrumentation->getTracer()->spanBuilder('AwsSDKInstrumentation')->setSpanKind(SpanKind::KIND_SERVER)->startSpan();
+$rootScope = $root->activate();
+
+// Initialize all AWS Client instances
+$s3Client = new S3Client([
+    'region' => 'us-west-2',
+    'version' => '2006-03-01',
+]);
+
+// Pass client instances to AWS SDK
+$awssdkinstrumentation->instrumentClients([$s3Client]);
+
+// Activate Instrumentation -- all AWS Client calls will be automatically instrumented
+$awssdkinstrumentation->activate();
+
+// Make S3 client call
+$result = $s3Client->listBuckets();
+
+// End the root span after all the calls to the AWS SDK have been made
+$root->end();
+$rootScope->detach();
+
+```
+
+## Useful Links and Resources 
+For more information on how to use the AWS SDK for PHP with AWS X-Ray and using the [AWS Distro for OpenTelemetry](https://aws-otel.github.io/), please see the [aws-otel-php repository](https://github.com/aws-observability/aws-otel-php).