Moesif Middleware for Go

by Moesif, the API analytics and API monetization platform.

Moesif middleware for Go logs API calls and sends to Moesif for API analytics and log analysis. This middleware allows you to integrate Moesif's API analytics and API monetization features into your Go applications with minimal configuration.

If you're new to Moesif, see our Getting Started resources to quickly get up and running.

Prerequisites

Before using this middleware, make sure you have the following:

Get Your Moesif Application ID

After you log into Moesif Portal, you can get your Moesif Application ID during the onboarding steps. You can always access the Application ID any time by following these steps from Moesif Portal after logging in:

Select the account icon to bring up the settings menu.
Select Installation or API Keys.
Copy your Moesif Application ID from the Collector Application ID field.

Install the Middleware

Use go get:

go get github.com/moesif/moesifmiddleware-go

If you are using Go modules, you can specify a version number as well:

go get github.com/moesif/[email protected]

Configure the Middleware

See the available configuration options to learn how to configure the middleware for your use case.

How to Use

The following snippet shows how to use the middleware:

import(
    moesifmiddleware "github.com/moesif/moesifmiddleware-go"
)

func handle(w http.ResponseWriter, r *http.Request) {
	// Your API Logic
}

var moesifOptions = map[string]interface{} {
        "Application_Id": "YOUR_MOESIF_APPLICATION_ID",
        "Log_Body": true,
}
http.Handle("/api", moesifmiddleware.MoesifMiddleware(http.HandlerFunc(handle), moesifOption))

Replace YOUR_MOESIF_APPLICATION_ID with your Moesif Application ID.

Optional: Capturing Outgoing API Calls

In addition to your own APIs, you can also start capturing calls out to third party services through the following method:

moesifmiddleware.StartCaptureOutgoing(moesifOption)

`handler func(ResponseWriter, *Request)` (Required)

The handler function registers the handler function for the given pattern through the HandlerFunc adapter. See the example application code for better understanding.

`moesifOption` (Required)

A map[string]interface{} type containing the configuration options for your application. See the example application code for better understanding.

See Configuration Options for the common configuration options. See Options for Logging Outgoing Calls for configuration options specific to capturing and logging outgoing API calls.

Troubleshoot

For a general troubleshooting guide that can help you solve common problems, see Server Troubleshooting Guide.

Other troubleshooting supports:

Configuration Options

The following sections describe the available configuration options for this middleware. You can set these options in the Moesif initialization options object. See the the example application code to understand how you can specify these options.

`Application_Id` (Required)

Data type
`string`

A string that identifies your application in Moesif.

`Should_Skip`

Data type	Parameters	Return type
Function	`(request, response)`	`boolean`

Optional.

A function that takes a request and a response, and returns true if you want to skip this particular event.

`Identify_User`

Data type	Parameters	Return type
Function	`(request, response)`	`string`

Optional, but highly recommended.

A function that takes a request and a response, and returns a string that represents the user ID used by your system.

Moesif identifies users automatically. However, due to the differences arising from different frameworks and implementations, provide this function to ensure user identification properly.

`Identify_Company`

Data type	Parameters	Return type
Function	`(request, response)`	`string`

Optional.

A function that takes a request and response, and returns a string that represents the company ID for this event.

`Get_Metadata`

Data type	Parameters	Return type
Function	`(request, response)`	`dictionary`

Optional.

A function that returns an object that allows you to add custom metadata that will be associated with the event.

The metadata must be a dictionary that can be converted to JSON. For example, you may want to save a virtual machine instance ID, a trace ID, or a tenant ID with the request.

`Get_Session_Token`

Data type	Parameters	Return type
Function	`(request, response)`	`string`

Optional.

A function that takes a request and response, and returns a string that represents the session token for this event.

Similar to users and companies, Moesif tries to retrieve session tokens automatically. But if it doesn't work for your service, provide this function to help identify sessions.

`Request_Header_Masks`

Data type	Parameters	Return type
Function	`()`	`[]string`

Optional.

A function that returns an array of strings to mask specific request header fields.

`Request_Body_Masks`

Data type	Parameters	Return type
Function	`()`	`[]string`

Optional.

A function that returns array of strings to mask specific request body fields.

`Response_Header_Masks`

Data type	Parameters	Return type
Function	`()`	`[]string`

Optional.

A function that returns array of strings to mask specific response header fields.

`Response_Body_Masks`

Data type	Parameters	Return type
Function	`()`	`[]string`

Optional.

A function that returns array of strings to mask specific response body fields.

`Debug`

Data type
`boolean`

Optional.

Set to true to see debugging messages. This may help you troubleshoot integration issues.

`Log_Body`

Data type	Default
`boolean`	`true`

Optional.

Set to false to not log the request and response body to Moesif.

`Event_Queue_Size`

Data type	Default
`int`	`10000`

An optional field name that specifies the maximum number of events to hold in queue before sending to Moesif. In case of network issues, the middleware may fail to connect to or send events to Moesif. For those scenarios, this option helps prevent adding new events to the queue to prevent memory overflow.

`Batch_Size`

Data type	Default
`int`	`200`

An optional field name that specifies the maximum batch size when sending to Moesif.

`Timer_Wake_Up_Seconds`

Data type	Default
`int`	`2`

An optional field that specifies a time in seconds how often background thread runs to send events to Moesif.

Options for Logging Outgoing Calls

The following configuration options apply to outgoing API calls. The request and response objects passed in are Request and Response objects of the Go standard library.

`Should_Skip_Outgoing`

Data type	Parameters	Return type
Function	`(request, response)`	`boolean`

Optional.

A function that takes a request and response, and returns true if you want to skip this particular event.

`Identify_User_Outgoing`

Data type	Parameters	Return type
Function	`(request, response)`	`string`

Optional, but highly recommended.

A function that takes a request and a response, and returns a string that represents the user ID used by your system.

Moesif identifies users automatically. However, due to the differences arising from different frameworks and implementations, provide this function to ensure user identification properly.

`Identify_Company_Outgoing`

Data type	Parameters	Return type
Function	`(request, response)`	`string`

Optional.

A function that takes request and response, and returns a string that represents the company ID for this event.

`Get_Metadata_Outgoing`

Data type	Parameters	Return type
Function	`(request, response)`	`dictionary`

Optional.

A function that returns an object that allows you to add custom metadata that will be associated with the event.

The metadata must be a dictionary that can be converted to JSON. For example, you may want to save a virtual machine instance ID, a trace ID, or a tenant ID with the request.

`Get_Session_Token_Outgoing`

Data type	Parameters	Return type
Function	`(request, response)`	`string`

Optional.

A function that takes a request and response, and returns a string that represents the session token for this event.

Similar to users and companies, Moesif tries to retrieve session tokens automatically. But if it doesn't work for your service, provide this function to help identify sessions and replay them.

`Log_Body_Outgoing`

Data type	Default
`boolean`	`true`

Optional.

Set to false to not log the request and response body to Moesif.

Examples

The following examples demonstrate some common operations:

Updating a single user
Updating users in batch
Updating a single company
Updating companies in batch
Updating a single subscription
Updating subscriptions in batch

Update User

`UpdateUser` Method

Use this method to create or update a user profile in Moesif.

import (
	moesifmiddleware "github.com/moesif/moesifmiddleware-go"
)

func literalFieldValue(value string) *string {
    return &value
}

var moesifOptions = map[string]interface{} {
	"Application_Id": "Your Moesif Application Id",
	"Log_Body": true,
}

// Campaign object is optional, but useful if you want to track ROI of acquisition channels
// See https://www.moesif.com/docs/api#users for campaign schema
campaign := models.CampaignModel {
  UtmSource: literalFieldValue("google"),
  UtmMedium: literalFieldValue("cpc"), 
  UtmCampaign: literalFieldValue("adwords"),
  UtmTerm: literalFieldValue("api+tooling"),
  UtmContent: literalFieldValue("landing"),
}
  
// metadata can be any custom dictionary
metadata := map[string]interface{}{
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "title": "Software Engineer",
  "sales_info": map[string]interface{}{
      "stage": "Customer",
      "lifetime_value": 24000,
      "account_owner": "[email protected]",
  },
}

// Only UserId is required
user := models.UserModel{
  UserId:  "12345",
  CompanyId:  literalFieldValue("67890"), // If set, associate user with a company object
  Campaign:  &campaign,
  Metadata:  &metadata,
}

// Update User
moesifmiddleware.UpdateUser(&user, moesifOption)

The metadata field can contain any user demographic or other information you want to store.

Only the UserId field is required. This method is a convenient helper that calls the Moesif API library. For more information, see Moesif Go API documentation.

`UpdateUsersBatch` Method

Similar to UpdateUser, but to update a list of users in one batch.

import (
	moesifmiddleware "github.com/moesif/moesifmiddleware-go"
)

func literalFieldValue(value string) *string {
    return &value
}

var moesifOptions = map[string]interface{} {
	"Application_Id": "Your Moesif Application Id",
}

// List of Users
var users []*models.UserModel

// Campaign object is optional, but useful if you want to track ROI of acquisition channels
// See https://www.moesif.com/docs/api#users for campaign schema
campaign := models.CampaignModel {
  UtmSource: literalFieldValue("google"),
  UtmMedium: literalFieldValue("cpc"), 
  UtmCampaign: literalFieldValue("adwords"),
  UtmTerm: literalFieldValue("api+tooling"),
  UtmContent: literalFieldValue("landing"),
}
  
// metadata can be any custom dictionary
metadata := map[string]interface{}{
  "email": "[email protected]",
  "first_name": "John",
  "last_name": "Doe",
  "title": "Software Engineer",
  "sales_info": map[string]interface{}{
      "stage": "Customer",
      "lifetime_value": 24000,
      "account_owner": "[email protected]",
  },
}

// Only UserId is required
userA := models.UserModel{
  UserId:  "12345",
  CompanyId:  literalFieldValue("67890"), // If set, associate user with a company object
  Campaign:  &campaign,
  Metadata:  &metadata,
}

users = append(users, &userA)

// Update User
moesifmiddleware.UpdateUsersBatch(users, moesifOption)

The metadata field can contain any company demographic or other information you want to store.

Only the UserId field is required. This method is a convenient helper that calls the Moesif API library. For more information, see Moesif Go API documentation

Update Company

`UpdateCompany` Method

Use this method to create or update a company profile in Moesif.

import (
	moesifmiddleware "github.com/moesif/moesifmiddleware-go"
)

func literalFieldValue(value string) *string {
    return &value
}

var moesifOptions = map[string]interface{} {
	"Application_Id": "Your Moesif Application Id",
}

// Campaign object is optional, but useful if you want to track ROI of acquisition channels
// See https://www.moesif.com/docs/api#update-a-company for campaign schema
campaign := models.CampaignModel {
  UtmSource: literalFieldValue("google"),
  UtmMedium: literalFieldValue("cpc"), 
  UtmCampaign: literalFieldValue("adwords"),
  UtmTerm: literalFieldValue("api+tooling"),
  UtmContent: literalFieldValue("landing"),
}
  
// metadata can be any custom dictionary
metadata := map[string]interface{}{
  "org_name": "Acme, Inc",
  "plan_name": "Free",
  "deal_stage": "Lead",
  "mrr": 24000,
  "demographics": map[string]interface{}{
      "alexa_ranking": 500000,
      "employee_count": 47,
  },
}

// Prepare company model
company := models.CompanyModel{
	CompanyId:		  "67890",	// The only required field is your company id
	CompanyDomain:  literalFieldValue("acmeinc.com"), // If domain is set, Moesif will enrich your profiles with publicly available info 
	Campaign: 		  &campaign,
	Metadata:		    &metadata,
}

// Update Company
moesifmiddleware.UpdateCompany(&company, moesifOption)

The metadata field can be any company demographic or other info you want to store.

Only the CompanyId field is required.

This method is a convenient helper that calls the Moesif API library. For details, see Moesif Go API documentation.

`UpdateCompaniesBatch` Method

Similar to UpdateCompany, but to update a list of companies in one batch.

import (
	moesifmiddleware "github.com/moesif/moesifmiddleware-go"
)

func literalFieldValue(value string) *string {
    return &value
}

var moesifOptions = map[string]interface{} {
	"Application_Id": "Your Moesif Application Id",
}

// List of Companies
var companies []*models.CompanyModel

// Campaign object is optional, but useful if you want to track ROI of acquisition channels
// See https://www.moesif.com/docs/api#update-a-company for campaign schema
campaign := models.CampaignModel {
  UtmSource: literalFieldValue("google"),
  UtmMedium: literalFieldValue("cpc"), 
  UtmCampaign: literalFieldValue("adwords"),
  UtmTerm: literalFieldValue("api+tooling"),
  UtmContent: literalFieldValue("landing"),
}
  
// metadata can be any custom dictionary
metadata := map[string]interface{}{
  "org_name": "Acme, Inc",
  "plan_name": "Free",
  "deal_stage": "Lead",
  "mrr": 24000,
  "demographics": map[string]interface{}{
      "alexa_ranking": 500000,
      "employee_count": 47,
  },
}

// Prepare company model
companyA := models.CompanyModel{
	CompanyId:		  "67890",	// The only required field is your company id
	CompanyDomain:  literalFieldValue("acmeinc.com"), // If domain is set, Moesif will enrich your profiles with publicly available info 
	Campaign: 		  &campaign,
	Metadata:		    &metadata,
}

companies = append(companies, &companyA)

// Update Companies
moesifmiddleware.UpdateCompaniesBatch(companies, moesifOption)

The metadata field can be any company demographic or other info you want to store.

Only the CompanyId field is required.

This method is a convenient helper that calls the Moesif API library. For details, see Moesif Go API documentation.

Update Subscription

`UpdateSubscription` Method

Use this method to create or update a subscription profile in Moesif.

import (
	moesifmiddleware "github.com/moesif/moesifmiddleware-go"
)

func literalFieldValue(value string) *string {
    return &value
}

var moesifOptions = map[string]interface{} {
	"Application_Id": "Your Moesif Application Id",
}

// metadata can be any custom dictionary
metadata := map[string]interface{}{
  "plan_name": "Pro",
  "deal_stage": "Customer",
  "mrr": 48000,
  "demographics": map[string]interface{}{
      "subscription_length": 12,
      "subscription_type": "annual",
  },
}

// Prepare subscription model
subscription := models.SubscriptionModel{
	SubscriptionId: "12345",	// Required subscription id
  CompanyId: "67890",       // Required company id
	Metadata: &metadata,
}

// Update Subscription
moesifmiddleware.UpdateSubscription(&subscription, moesifOptions)

The metadata field can be any subscription demographic or other information you want to store.

Only the SubscriptionId and CompanyId fields are required.

This method is a convenient helper that calls the Moesif API library. For more information, see Moesif Go API documentation.

`UpdateSubscriptionsBatch` method

Similar to UpdateSubscription, but to update a list of subscriptions in one batch.

import (
	moesifmiddleware "github.com/moesif/moesifmiddleware-go"
)

func literalFieldValue(value string) *string {
    return &value
}

var moesifOptions = map[string]interface{} {
	"Application_Id": "Your Moesif Application Id",
}

// List of Subscriptions
var subscriptions []*models.SubscriptionModel

// metadata can be any custom dictionary
metadata := map[string]interface{}{
  "plan_name": "Pro",
  "deal_stage": "Customer",
  "mrr": 48000,
  "demographics": map[string]interface{}{
      "subscription_length": 12,
      "subscription_type": "annual",
  },
}

// Prepare subscription model
subscriptionA := models.SubscriptionModel{
	SubscriptionId: "12345",	// Required subscription id
  CompanyId: "67890",       // Required company id
	Metadata: &metadata,
}

subscriptions = append(subscriptions, &subscriptionA)

// Update Subscriptions
moesifmiddleware.UpdateSubscriptionsBatch(subscriptions, moesifOptions)

The metadata field can be any subscription demographic or other information you want to store.

Only the SubscriptionId and CompanyId fields are required.

This method is a convenient helper that calls the Moesif API library. For more information, see Moesif Go API documentation.

Explore Other Integrations

Explore other integration options from Moesif:

Name		Name	Last commit message	Last commit date
Latest commit History 85 Commits
images		images
.gitignore		.gitignore
LICENSE		LICENSE
README.md		README.md
appconfig.go		appconfig.go
appconfig_test.go		appconfig_test.go
captureoutgoing.go		captureoutgoing.go
clientip.go		clientip.go
go.mod		go.mod
go.sum		go.sum
governance_rules.go		governance_rules.go
loggerhelper.go		loggerhelper.go
moesifmiddleware.go		moesifmiddleware.go
sendmoesif.go		sendmoesif.go

License

Moesif/moesifmiddleware-go

Folders and files

Latest commit

History

Repository files navigation

Moesif Middleware for Go

Prerequisites

Get Your Moesif Application ID

Install the Middleware

Configure the Middleware

How to Use

Optional: Capturing Outgoing API Calls

handler func(ResponseWriter, *Request) (Required)

moesifOption (Required)

Troubleshoot

Configuration Options

Application_Id (Required)

Should_Skip

Identify_User

Identify_Company

Get_Metadata

Get_Session_Token

Request_Header_Masks

Request_Body_Masks

Response_Header_Masks

Response_Body_Masks

Debug

Log_Body

Event_Queue_Size

Batch_Size

Timer_Wake_Up_Seconds

Options for Logging Outgoing Calls

Should_Skip_Outgoing

Identify_User_Outgoing

Identify_Company_Outgoing

Get_Metadata_Outgoing

Get_Session_Token_Outgoing

Log_Body_Outgoing

Examples

Update User

UpdateUser Method

UpdateUsersBatch Method

Update Company

UpdateCompany Method

UpdateCompaniesBatch Method

Update Subscription

UpdateSubscription Method

UpdateSubscriptionsBatch method

Explore Other Integrations

About

Topics

Resources

License

Stars

Watchers

Forks

Releases 21

Packages 0

Contributors 9

Languages

`handler func(ResponseWriter, *Request)` (Required)

`moesifOption` (Required)

`Application_Id` (Required)

`Should_Skip`

`Identify_User`

`Identify_Company`

`Get_Metadata`

`Get_Session_Token`

`Request_Header_Masks`

`Request_Body_Masks`

`Response_Header_Masks`

`Response_Body_Masks`

`Debug`

`Log_Body`

`Event_Queue_Size`

`Batch_Size`

`Timer_Wake_Up_Seconds`

`Should_Skip_Outgoing`

`Identify_User_Outgoing`

`Identify_Company_Outgoing`

`Get_Metadata_Outgoing`

`Get_Session_Token_Outgoing`

`Log_Body_Outgoing`

`UpdateUser` Method

`UpdateUsersBatch` Method

`UpdateCompany` Method

`UpdateCompaniesBatch` Method

`UpdateSubscription` Method

`UpdateSubscriptionsBatch` method

Packages