API endpoint for online check

javierxam · August 16, 2024, 8:45pm

Hello!!

is there any endpoint in the node api i can pull for checking the online status?

Roxor · August 16, 2024, 8:58pm

I know if you watch quicStatus from /api/sno and it says “OK”… then you’re for sure also Status=Online. But if it says “Misconfigured” then I’m not sure what you’d check next. If you find another place to query I’m interested too!

javierxam · August 16, 2024, 9:00pm

My quicStatus is misconfigured, i’m searching but nothing found so far

ItsHass · August 16, 2024, 9:50pm

A good way to see if your online is to measure a 30 second gap in the disk utilisation, if there is a increase, on any satellite, you know it’s online

Mark · August 16, 2024, 10:16pm

I believe the old command line dashboard utility used the time since “lastPinged” to see if it was online.

const contactWindow = time.Hour * 2

github.com

storj/storj/blob/403e17d3d48d05fa175ac5d9a8f17ae343e30391/cmd/storagenode/cmd_dashboard.go#L121


      
          	var warnFlag bool
          	color.NoColor = !cfg.UseColor
          
          	heading := color.New(color.FgGreen, color.Bold)
          	_, _ = heading.Printf("\nStorage Node Dashboard ( Node Version: %s )\n", version.Build.Version.String())
          	_, _ = heading.Printf("\n======================\n\n")
          
          	w := tabwriter.NewWriter(color.Output, 0, 0, 1, ' ', 0)
          	_, _ = fmt.Fprintf(w, "ID\t%s\n", color.YellowString(data.NodeId.String()))
          
          	if data.LastPinged.IsZero() || time.Since(data.LastPinged) >= contactWindow {
          		_, _ = fmt.Fprintf(w, "Status\t%s\n", color.RedString("OFFLINE"))
          	} else {
          		_, _ = fmt.Fprintf(w, "Status\t%s\n", color.GreenString("ONLINE"))
          	}
          
          	uptime, err := time.ParseDuration(data.GetUptime())
          	if err == nil {
          		_, _ = fmt.Fprintf(w, "Uptime\t%s\n", color.YellowString(uptime.Truncate(time.Second).String()))
          	}

Roxor · August 16, 2024, 10:37pm

I don’t know what contactWindow evaluates to, but if this is a shell script it looks like lastPinged is easy to convert. Like:

date -d "2024-08-16T22:29:28.041650338Z" +'%s'

…will turn lastPinged into seconds, and:

date +'%s'

…will give you the current time in seconds. Then you can just subtract them and decide how large a discrepancy is OK to still be considered Online. Clever!

storaje · August 16, 2024, 10:51pm

Just HTTP GET on your external storagenode port (28967).

{
  "Statuses": null,
  "Help": "To access Storagenode services, please use DRPC protocol!",
  "AllHealthy": true
}

Alexey · August 17, 2024, 4:55am