rest api: /debug/settings/pprof admin endpoint for debugging (algoran…

…d#6018)
Algo-devops-service · Jun 7, 2024 · f06a86e · f06a86e
1 parent 9853ab2
commit f06a86e
Show file tree

Hide file tree

Showing 12 changed files with 1,718 additions and 1,361 deletions.
diff --git a/daemon/algod/api/algod.oas2.json b/daemon/algod/api/algod.oas2.json
@@ -178,6 +178,44 @@
         }
       }
     },
+    "/debug/settings/pprof": {
+      "get": {
+        "description": "Retrieves the current settings for blocking and mutex profiles",
+        "tags": [
+          "private"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "schemes": [
+          "http"
+        ],
+        "operationId": "GetDebugSettingsProf",
+        "responses": {
+          "200": {
+            "$ref": "#/responses/DebugSettingsProfResponse"
+          }
+        }
+      },
+      "put": {
+        "description": "Enables blocking and mutex profiles, and returns the old settings",
+        "tags": [
+          "private"
+        ],
+        "produces": [
+          "application/json"
+        ],
+        "schemes": [
+          "http"
+        ],
+        "operationId": "PutDebugSettingsProf",
+        "responses": {
+          "200": {
+            "$ref": "#/responses/DebugSettingsProfResponse"
+          }
+        }
+      }
+    },
     "/v2/accounts/{address}": {
       "get": {
         "description": "Given a specific account public key, this call returns the accounts status, balance and spendable amounts",
@@ -4053,6 +4091,26 @@
         }
       }
     },
+    "DebugSettingsProf": {
+      "description": "algod mutex and blocking profiling state.",
+      "type": "object",
+      "title": "algod mutex and blocking profiling state.",
+      "tags": [
+        "private"
+      ],
+      "properties": {
+        "block-rate": {
+          "description": "The rate of blocking events. The profiler aims to sample an average of one blocking event per rate nanoseconds spent blocked. To turn off profiling entirely, pass rate 0.",
+          "example": 1000,
+          "type": "integer"
+        },
+        "mutex-rate": {
+          "description": "The rate of mutex events. On average 1/rate events are reported. To turn off profiling entirely, pass rate 0",
+          "example": 1000,
+          "type": "integer"
+        }
+      }
+    },
     "BuildVersion": {
       "tags": [
         "common"
@@ -5500,6 +5558,12 @@
       "schema": {
         "$ref": "#/definitions/Version"
       }
+    },
+    "DebugSettingsProfResponse": {
+      "description": "DebugPprof is the response to the /debug/extra/pprof endpoint",
+      "schema": {
+        "$ref": "#/definitions/DebugSettingsProf"
+      }
     }
   },
   "securityDefinitions": {

diff --git a/daemon/algod/api/algod.oas3.yml b/daemon/algod/api/algod.oas3.yml
@@ -520,6 +520,16 @@
         },
         "description": "Teal compile Result"
       },
+      "DebugSettingsProfResponse": {
+        "content": {
+          "application/json": {
+            "schema": {
+              "$ref": "#/components/schemas/DebugSettingsProf"
+            }
+          }
+        },
+        "description": "DebugPprof is the response to the /debug/extra/pprof endpoint"
+      },
       "DisassembleResponse": {
         "content": {
           "application/json": {
@@ -1790,6 +1800,23 @@
         "title": "BuildVersion contains the current algod build version information.",
         "type": "object"
       },
+      "DebugSettingsProf": {
+        "description": "algod mutex and blocking profiling state.",
+        "properties": {
+          "block-rate": {
+            "description": "The rate of blocking events. The profiler aims to sample an average of one blocking event per rate nanoseconds spent blocked. To turn off profiling entirely, pass rate 0.",
+            "example": 1000,
+            "type": "integer"
+          },
+          "mutex-rate": {
+            "description": "The rate of mutex events. On average 1/rate events are reported. To turn off profiling entirely, pass rate 0",
+            "example": 1000,
+            "type": "integer"
+          }
+        },
+        "title": "algod mutex and blocking profiling state.",
+        "type": "object"
+      },
       "DryrunRequest": {
         "description": "Request data type for dryrun endpoint. Given the Transactions and simulated ledger state upload, run TEAL scripts and return debugging information.",
         "properties": {
@@ -2748,6 +2775,46 @@
   },
   "openapi": "3.0.1",
   "paths": {
+    "/debug/settings/pprof": {
+      "get": {
+        "description": "Retrieves the current settings for blocking and mutex profiles",
+        "operationId": "GetDebugSettingsProf",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DebugSettingsProf"
+                }
+              }
+            },
+            "description": "DebugPprof is the response to the /debug/extra/pprof endpoint"
+          }
+        },
+        "tags": [
+          "private"
+        ]
+      },
+      "put": {
+        "description": "Enables blocking and mutex profiles, and returns the old settings",
+        "operationId": "PutDebugSettingsProf",
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/DebugSettingsProf"
+                }
+              }
+            },
+            "description": "DebugPprof is the response to the /debug/extra/pprof endpoint"
+          }
+        },
+        "tags": [
+          "private"
+        ]
+      }
+    },
     "/genesis": {
       "get": {
         "description": "Returns the entire genesis file in json.",

diff --git a/daemon/algod/api/server/common/handlers.go b/daemon/algod/api/server/common/handlers.go
@@ -186,8 +186,6 @@ func VersionsHandler(ctx lib.ReqContext, context echo.Context) {
 		},
 	}
 	json.NewEncoder(w).Encode(response.Body)
-
-	return
 }
 
 // CORS
-Original file line number
+Diff line change
@@ Expand Up @@
     		},
     	}
     	json.NewEncoder(w).Encode(response.Body)
-    	return
     }
     // CORS
@@ Expand Down @@