Home - News ( United States | United Kingdom | Italy | Germany ) - Football scores

Showing content from https://github.com/signalfx/lambda-csharp below:

signalfx/lambda-csharp: SignalFx AWS Lambda C# Wrapper (Deprecated)

ℹ️  SignalFx was acquired by Splunk in October 2019. See Splunk SignalFx for more information.

The SignalFx .NET Lambda Wrapper is deprecated. Only critical security fixes and bug fixes are provided.

After October 9th, 2024 this repository will be archived (read-only). After October 9th, 2024, no updates will be provided and this repository will be unsupported.

Going forward, Lambda functions should use the Splunk OpenTelemetry Lambda Layer, which offers similar capabilities and fully supports the OpenTelemetry standard. To learn more about the Splunk OTel Lambda Layer, see https://docs.splunk.com/Observability/gdi/get-data-in/serverless/aws/otel-lambda-layer/instrument-lambda-functions.html#nav-Instrument-your-Lambda-function

The SignalFx .NET Lambda Wrapper wraps around an AWS Lambda .NET or ASP.NET Core function handler. This enables you to send metrics and traces to Splunk APM.

The Lambda wrapper manually instruments the Lambda function itself, and not any libraries or frameworks. To get traces from libraries and frameworks in the Lambda function, manually instrument them.

To see manual instrumentation in action, see the OpenTracing examples.

There are two options to use the SignalFx Lambda wrapper:

• Manually deploy the Lambda wrapper to your code
• Use a Lambda layer that Splunk hosts

Follow these steps to add the SignalFx Lambda wrapper for .NET or ASP.NET Core.

Add the signalfx-lambda-functions NuGet package to your project.

After adding the NuGet package, what to do next depends on whether you're instrumenting .NET or ASP.NET Core. See the following sections according to what you're instrumenting.

Follow these steps to add the wrapper to your ASP.NET Core Lambda function after adding the NuGet package.

1. Change the base class of your LambdaEntryPoint to the corresponding wrapper class:

   Original AWS Base Type Wrapper Type APIGatewayProxyFunction APIGatewayProxyFunctionWrapper APIGatewayHttpApiV2ProxyFunction APIGatewayHttpApiV2ProxyFunctionWrapper

2. Add TracingDecoratorFilter to the Startup.ConfigureServices method to enrich span data. Here's an example of what this looks like:

           public void ConfigureServices(IServiceCollection services)
           {
               // Add the tracing decorator to enrich span data.
               services.AddControllers(config => config.Filters.Add(new TracingDecoratorFilter()));
           }

   Check out these sample projects for working examples:

   • Sample ASP.NET Core AWS HttpApi V1
   • Sample ASP.NET Core AWS HttpApi V2

Manually add the wrapper to the code of the function type:

        // Static reference to the SignalFx function wrapper.
        private static FunctionWrapper s_functionWrapper = new FunctionWrapper();

        ...

        /// <summary>
        /// This is the modified handler to use the wrapper over a non-void synchronous function.
        /// </summary>
        public string FunctionWithReturn(string input, ILambdaContext context)
        {
            return s_functionWrapper.Invoke(OriginalFunctionWithReturn, input, context);
        }

Check out this sample project for a working example:

• Sample Lambda Functions

The are overloads of the Invoke method with different signatures to support the typical function signatures and specific ones to support API Gateway functions:

• InvokeAPIGatewayProxyAsync
• InvokeAPIGatewayHttpApiV2ProxyAsync

All of the methods above support enrichment of spans with these optional parameters:

You can also enrich spans with environment variables. For more information, see Configure the SignalFx Tracing Library for .NET.

Use your realm to configure your ingest endpoint and an access token to associate data to your organization.

To find which realm you're in, go to Settings > My Profile.

To find or create an access token for your organization, go to Settings > Organization Settings > Access Tokens.

Follow these steps to configure your access token and ingest endpoint:

1. Set SIGNALFX_ACCESS_TOKEN with your access token:

   SIGNALFX_ACCESS_TOKEN=<access-token>

2. Set SIGNALFX_ENDPOINT_URL with your organization's realm:

   SIGNALFX_ENDPOINT_URL=https://ingest.<realm>.signalfx.com

   If you're sending data to an OpenTelemetry Collector, you have to specify the full path like this: http://<otel-collector-host>:9411/api/v2/spans

3. Set SIGNALFX_ENV to specify the environment for the service in APM:

   SIGNALFX_ENV="yourEnvironment"

4. If you didn't already specify span tags with the tags parameter, add span tags to each span by setting SIGNALFX_TRACE_GLOBAL_TAGS:

   SIGNALFX_TRACE_GLOBAL_TAGS="key1:val1,key2:val2"

5. (Optional) Globally enable metrics by setting SIGNALFX_METRICS_ENABLED:

   SIGNALFX_METRICS_ENABLED=true

6. (Optional) Disable context propagation. The wrapper currently supports only B3 context propagation. By default, you should enable context propagation. The option to disable this is for security considerations.

   SIGNALFX_CTX_PROPAGATION_ENABLED=false

7. (Optional) Specify other environment variables to better configure the traces.

   For a list of all the available configuration options available, see Configure the SignalFx Tracing Library for .NET.

Add a layer that includes the SignalFx Lambda wrapper to your Lambda function. A layer is code and other content that you can run without including it in your deployment package. SignalFx provides layers in all supported regions you can freely use. If you want to reduce the size of your deployment, you can add the package as a developer dependency, but in a production environment you should add the wrapper as a layer to reduce the deployment size.

To learn more about AWS Lambda Layers, see AWS Lambda layers on the AWS website.

If you want detailed information about using AWS Lambda Layers with .NET Core, see Layers for .NET Core Lambda Functions.

Follow these steps to use the SignalFx .NET Lambda Wrapper layer. You can also use a Lambda configuration file or the AWS Extensions for .NET CLI. See the following sections for examples. The examples use netcoreapp3.1 as the target framework, but netcoreapp2.1 is also supported.

1. From the AWS console, add a layer to your Lambda function code.
2. Get the ARN layer according to the deployment region and .NET runtime of your Lambda:
   • NetCoreApp 2.1
   • NetCoreApp 3.1
3. Add the environment variable DOTNET_SHARED_STORE to /opt/dotnetcore/store/ to Lambda configuration.
4. Explicitly set framework and function-runtime to ensure proper deployment.
5. Add the layer ARN to the set of layers the Lambda function uses.

Use the json configuration file to build and deploy your Lambda function. By default, this is named aws-lambda-tools-defaults.json.

       "environment-variables" : "\"DOTNET_SHARED_STORE\"=\"/opt/dotnetcore/store/\"",
       "framework"             : "netcoreapp3.1",
       "function-runtime"      : "dotnetcore3.1",
       "function-layers"       : "<arn-from-step-1>",

Add these parameters with the AWS Extensions for .NET CLI CLI to build and deploy your Lambda function:

      --environment-variables DOTNET_SHARED_STORE=/opt/dotnetcore/store/ 
      --framework netcoreapp3.1
      --function-runtime dotnetcore3.1
      --function-layers <arn-from-step-1>

The Lambda wrapper sends these metrics to Splunk APM:

The Lambda wrapper adds these dimensions to all data points it sends to Splunk APM:

The tracing wrapper creates a span for the wrapper handler. That span contains these tags:

There are several ways to add extra tags or enrich the traces of your service:

• Pass span tags with the tags parameter.
• Update the span name with the operationName parameter.
• For ASP.NET Core applications, add custom action filters to add tags or various other operations available to manual instrumentation.
• Use the TracingDecoratorFilter as a starting point for your own implementation.
• Use OpenTracing anywhere in your application to add span tags, spans, or context propagation. Use the examples as a starting point. You don't need to add a package the project since signalfx-lambda-functions includes the OpenTracing library.

Apache Software License v2. Copyright © 2014-2021 Splunk

ℹ️  SignalFx was acquired by Splunk in October 2019. See Splunk SignalFx for more information.

RetroSearch is an open source project built by @garambo | Open a GitHub Issue

Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo

HTML: 3.2 | Encoding: UTF-8 | Version: 0.7.4