The Instana Go Event API is a simple method to report custom events into your dashboard. These events can range from generic change events to more severe events tied to a specific host or service.
Events are a versatile way to broaden the knowledge base that Instana has to continuously monitor, learn from and alert on your environment.
Suppose that we have a remote point of presence monitoring a specific public microservice (games) in Eastern Asia that is critical to our infrastructure for that local area. When that monitor detects slow response times to it's queries, it reports a custom high latency event to Instana.
The following example shows how such Go code would send a critical event on the service games.
package main
import (
"time"
"github.com/instana/go-sensor"
)
func main() {
instana.InitSensor(&instana.Options{Service: service})
go forever()
select {}
}
func forever() {
for {
instana.SendServiceEvent("games",
"Games High Latency", "Games - High latency from East Asia POP.",
instana.SeverityCritical, 1*time.Second)
time.Sleep(30 * time.Second)
}
}The critical event is reported to the Instana Service Quality Engine, it is logged to the dashboard and directly affects the state of the games service:
