Stardust.Continuum.Client 2.0.1

Client for the continuum live log stream service

There is a newer version of this package available.
See the version list below for details.
Install-Package Stardust.Continuum.Client -Version 2.0.1
dotnet add package Stardust.Continuum.Client --version 2.0.1
<PackageReference Include="Stardust.Continuum.Client" Version="2.0.1" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Stardust.Continuum.Client --version 2.0.1
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#Continuum

plural continuaplay -yü-ə\ also continuums

1: a coherent whole characterized as a collection, sequence, or progression of values or elements varying by minute degrees “good” and “bad” … stand at opposite ends of a continuum instead of describing the two halves of a line — Wayne Shumaker

2: the set of real numbers including both the rationals and the irrationals; broadly : a compact set which cannot be separated into two sets neither of which contains a limit point of the other

In modern SOA or micro services architectures we spread processing and handling of user request across multiple machines and instances making debugging and troubleshooting harder. This tool allows all instances to stream log
entries to a centralized service. The developers can on their side connect to the Continuum UI and watch all entries flow through the system, pause if anything interesting happens to investigate further.

##Service setup:

  • Download the web deployment package here: Web Deploy Package

  • Follow the instructions: How to: Install a Deployment Package

  • Add your projects and environments in the web.config file.

    • <add key="project.environment" value="apikey"/ >
  • Add Authentication

    • <add key="authority" value="azure ad url or adfs 2016 url"/ >
    • <add key="clientId" value="appId from IDP"/ >

##Usage:

Direct

LogStreamConfig.ApiKey = apiKeyFromConfig;//only once per app instance
await ProxyFactory.CreateInstance<ILogStream>(serviceUrl).AddAddStream(projectIdentifier, environmentName,new StreamItem{});

Wrapper client:

Initialization

//Initialization, can also be added in config AppSettings section (see trailing comment);

ContinuumClient.BaseUrl=serviceUrl; // <add key="continuum:apiUrl" value="https://http://continuumdemo.azurewebsites.net/"/>
ContinuumClient.Project=projectIdentifier; // <add key="continuum:project"  value="test"/>
ContinuumClient.Environment=environmentName; // <add key="continuum:environment" value="test"/>
ContinuumClient.ApiKey=apiKeyFromConfig; // <add key="continuum:apiKey" value="test123"/>

Add to stream


//Write to log stream. This call does not block the execution of the main process.
ContinuumClient.AddStream(new StreamItem{ Message="this is a new log entry. added as a sample", LogLevel=LogLevels.Debug, UserName=User.Name, CorrelationToken=ActivityId});

#Continuum

plural continuaplay -yü-ə\ also continuums

1: a coherent whole characterized as a collection, sequence, or progression of values or elements varying by minute degrees “good” and “bad” … stand at opposite ends of a continuum instead of describing the two halves of a line — Wayne Shumaker

2: the set of real numbers including both the rationals and the irrationals; broadly : a compact set which cannot be separated into two sets neither of which contains a limit point of the other

In modern SOA or micro services architectures we spread processing and handling of user request across multiple machines and instances making debugging and troubleshooting harder. This tool allows all instances to stream log
entries to a centralized service. The developers can on their side connect to the Continuum UI and watch all entries flow through the system, pause if anything interesting happens to investigate further.

##Service setup:

  • Download the web deployment package here: Web Deploy Package

  • Follow the instructions: How to: Install a Deployment Package

  • Add your projects and environments in the web.config file.

    • <add key="project.environment" value="apikey"/ >
  • Add Authentication

    • <add key="authority" value="azure ad url or adfs 2016 url"/ >
    • <add key="clientId" value="appId from IDP"/ >

##Usage:

Direct

LogStreamConfig.ApiKey = apiKeyFromConfig;//only once per app instance
await ProxyFactory.CreateInstance<ILogStream>(serviceUrl).AddAddStream(projectIdentifier, environmentName,new StreamItem{});

Wrapper client:

Initialization

//Initialization, can also be added in config AppSettings section (see trailing comment);

ContinuumClient.BaseUrl=serviceUrl; // <add key="continuum:apiUrl" value="https://http://continuumdemo.azurewebsites.net/"/>
ContinuumClient.Project=projectIdentifier; // <add key="continuum:project"  value="test"/>
ContinuumClient.Environment=environmentName; // <add key="continuum:environment" value="test"/>
ContinuumClient.ApiKey=apiKeyFromConfig; // <add key="continuum:apiKey" value="test123"/>

Add to stream


//Write to log stream. This call does not block the execution of the main process.
ContinuumClient.AddStream(new StreamItem{ Message="this is a new log entry. added as a sample", LogLevel=LogLevels.Debug, UserName=User.Name, CorrelationToken=ActivityId});

Release Notes

netstandard version

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
2.4.0 528 8/20/2019
2.3.1 75 8/19/2019
2.2.2 1,912 12/3/2018
2.2.1 714 10/1/2018
2.1.1 568 7/5/2018
2.1.0 267 6/27/2018
2.1.0-pre003 255 6/25/2018
2.1.0-pre001 337 4/10/2018
2.0.1 424 3/6/2018
2.0.1-pre0002 297 3/5/2018
2.0.1-pre0001 349 2/23/2018
2.0.0-pre 342 12/13/2017
1.2.5 929 6/19/2017
1.2.3 1,029 5/22/2017
1.2.1 3,177 2/21/2017
1.2.0 342 2/20/2017
1.1.0 326 1/30/2017
1.0.0.3-alpha1 798 1/25/2017
1.0.0.2-alpha1 447 1/23/2017
Show less