Add telemetry-only diagnostics

Author: owen-mc

go/extractor/cli/go-autobuilder/go-autobuilder.go

@@ -709,14 +709,14 @@ func checkForUnsupportedVersions(v versionInfo) (msg, version string) {
 		msg = "The version of Go found in the `go.mod` file (" + v.goModVersion +
 			") is outside of the supported range (" + minGoVersion + "-" + maxGoVersion + ")."
 		version = ""
-		//TODO: emit diagnostic
+		diagnostics.EmitUnsupportedVersionGoMod(msg)
 	}
 
 	if v.goInstallationFound && outsideSupportedRange(v.goEnvVersion) {
 		msg = "The version of Go installed in the environment (" + v.goEnvVersion +
 			") is outside of the supported range (" + minGoVersion + "-" + maxGoVersion + ")."
 		version = ""
-		//TODO: emit diagnostic
+		diagnostics.EmitUnsupportedVersionEnvironment(msg)
 	}
 
 	return msg, version
@@ -728,17 +728,20 @@ func checkForVersionsNotFound(v versionInfo) (msg, version string) {
 			"`environment.json` file specifying the maximum supported version of Go (" +
 			maxGoVersion + ")."
 		version = maxGoVersion
+		diagnostics.EmitNoGoModAndNoGoEnv(msg)
 	}
 
 	if !v.goInstallationFound && v.goDirectiveFound {
 		msg = "No version of Go installed. Writing an `environment.json` file specifying the " +
 			"version of Go found in the `go.mod` file (" + v.goModVersion + ")."
 		version = v.goModVersion
+		diagnostics.EmitNoGoEnv(msg)
 	}
 
 	if v.goInstallationFound && !v.goDirectiveFound {
 		msg = "No `go.mod` file found. Version " + v.goEnvVersion + " installed in the environment."
 		version = ""
+		diagnostics.EmitNoGoMod(msg)
 	}
 
 	return msg, version
@@ -751,10 +754,12 @@ func compareVersions(v versionInfo) (msg, version string) {
 			").\nWriting an `environment.json` file specifying the version of Go from the " +
 			"`go.mod` file (" + v.goModVersion + ")."
 		version = v.goModVersion
+		diagnostics.EmitVersionGoModHigherVersionEnvironment(msg)
 	} else {
 		msg = "The version of Go installed in the environment (" + v.goEnvVersion +
 			") is high enough for the version found in the `go.mod` file (" + v.goModVersion + ")."
 		version = ""
+		diagnostics.EmitVersionGoModNotHigherVersionEnvironment(msg)
 	}
 
 	return msg, version

go/extractor/diagnostics/diagnostics.go

@@ -30,6 +30,7 @@ type visibilityStruct struct {
 }
 
 var fullVisibility *visibilityStruct = &visibilityStruct{true, true, true}
+var telemetryOnly *visibilityStruct = &visibilityStruct{false, false, true}
 
 type locationStruct struct {
 	File        string `json:"file,omitempty"`
@@ -192,3 +193,80 @@ func EmitRelativeImportPaths() {
 		noLocation,
 	)
 }
+
+func EmitUnsupportedVersionGoMod(msg string) {
+	emitDiagnostic(
+		"go/identify-environment/unsupported-version-in-go-mod",
+		"Unsupported Go version in `go.mod` file",
+		msg,
+		severityError,
+		telemetryOnly,
+		noLocation,
+	)
+}
+
+func EmitUnsupportedVersionEnvironment(msg string) {
+	emitDiagnostic(
+		"go/identify-environment/unsupported-version-in-environment",
+		"Unsupported Go version in environment",
+		msg,
+		severityError,
+		telemetryOnly,
+		noLocation,
+	)
+}
+
+func EmitNoGoModAndNoGoEnv(msg string) {
+	emitDiagnostic(
+		"go/identify-environment/no-go-mod-and-no-go-env",
+		"No `go.mod` file found and no Go version in environment",
+		msg,
+		severityNote,
+		telemetryOnly,
+		noLocation,
+	)
+}
+
+func EmitNoGoEnv(msg string) {
+	emitDiagnostic(
+		"go/identify-environment/no-go-mod-and-no-go-env",
+		"No Go version in environment",
+		msg,
+		severityNote,
+		telemetryOnly,
+		noLocation,
+	)
+}
+
+func EmitNoGoMod(msg string) {
+	emitDiagnostic(
+		"go/identify-environment/no-go-mod",
+		"No `go.mod` file found",
+		msg,
+		severityNote,
+		telemetryOnly,
+		noLocation,
+	)
+}
+
+func EmitVersionGoModHigherVersionEnvironment(msg string) {
+	emitDiagnostic(
+		"go/identify-environment/version-go-mod-higher-than-go-env",
+		"The Go version in `go.mod` file is higher than the Go version in environment",
+		msg,
+		severityWarning,
+		telemetryOnly,
+		noLocation,
+	)
+}
+
+func EmitVersionGoModNotHigherVersionEnvironment(msg string) {
+	emitDiagnostic(
+		"go/identify-environment/version-go-mod-not-higher-than-go-env",
+		"The Go version in `go.mod` file is not higher than the Go version in environment",
+		msg,
+		severityNote,
+		telemetryOnly,
+		noLocation,
+	)
+}