Error Code Reference

Error Codes and Troubleshooting

Meshery and it’s components use a common framework (defined within MeshKit) to generate and document an error with a unique identifier - an error code. Each error code identifies the source component for the error and a standard set of information to describe the error and provide helpful details for troubleshooting the situation surrounding the specific error.

Error Code Categories by Component

Component Type Component Name
adapter Kuma
library meshkit
client mesheryctl
adapter linkerd
library meshery-adapter-library
component meshery-server

Meshery Adapter for Kuma

Error Name Error Code Severity Short Description Long Description Probable Cause Suggested Remediation
ErrInstallKumaCode 1000
ErrMeshConfigCode 1001
ErrFetchManifestCode 1002
ErrClientConfigCode 1003
ErrClientSetCode 1004
ErrStreamEventCode 1005
ErrSampleAppCode 1006
ErrGetKumactlCode 1007
ErrDownloadBinaryCode 1008
ErrInstallBinaryCode 1009
ErrUntarCode 1010
ErrUntarDefaultCode 1011
ErrMoveBinaryCode 1012
ErrCustomOperationCode 1013

Top



meshkit library

Error Name Error Code Severity Short Description Long Description Probable Cause Suggested Remediation
ErrNoneDatabaseCode 11010 Alert No Database selected database name is empty Input a name for the database
ErrDatabaseOpenCode 11011 Alert Unable to open database Database is unreachable Make sure your database is reachable
ErrSQLMapUnmarshalJSONCode 11012 Alert failed to unmarshal json
ErrSQLMapUnmarshalTextCode 11013 Alert failed to unmarshal text
ErrSQLMapMarshalValueCode 11014 Alert failed to marshal value
ErrSQLMapUnmarshalScannedCode 11015
ErrSQLMapInvalidScanCode 11016
ErrApplyManifestCode 11021 Alert Error Applying manifest Manifest could be invalid Make sure manifest yaml is valid
ErrServiceDiscoveryCode 11022 Alert Error Discovering service Network not reachable to the service Make sure the endpoint is reachable
ErrApplyHelmChartCode 11023 Alert Error applying helm chart Chart could be invalid Make sure to apply valid chart
ErrNewKubeClientCode 11024 Alert Error creating kubernetes clientset Kubernetes config is not accessible to meshery or not valid Upload your kubernetes config via the settings dashboard. If uploaded, wait for a minute for it to get initialized
ErrNewDynClientCode 11025 Alert Error creating dynamic client Kubernetes config is not accessible to meshery or not valid Upload your kubernetes config via the settings dashboard. If uploaded, wait for a minute for it to get initialized
ErrNewDiscoveryCode 11026 Alert Error creating discovery client Discovery resource is invalid or doesnt exist Makes sure the you input valid resource for discovery
ErrNewInformerCode 11027 Alert Error creating informer client Informer is invalid or doesnt exist Makes sure the you input valid resource for the informer
ErrEndpointNotFoundCode 11028 Alert Unable to discover an endpoint
ErrInvalidAPIServerCode 11029 Alert Invalid API Server URL
ErrLoadConfigCode 11030 Alert Error loading kubernetes config Kubernetes config is not accessible to meshery or not valid Upload your kubernetes config via the settings dashboard. If uploaded, wait for a minute for it to get initialized
ErrValidateConfigCode 11031 Alert Validation failed in the kubernetes config Kubernetes config is not accessible to meshery or not valid Upload your kubernetes config via the settings dashboard. If uploaded, wait for a minute for it to get initialized
ErrExposeResourceCode 11032 Alert
ErrGettingResourceCode 11033 Alert
ErrTraverserCode 11034 Alert
ErrResourceCannotBeExposedCode 11035 Alert resource type %s cannot be exposed:
ErrSelectorBasedMapCode 11036 Alert
ErrProtocolBasedMapCode 11037 Alert
ErrLableBasedMapCode 11038 Alert
ErrPortParsingCode 11039 Alert
ErrGenerateServiceCode 11040 Alert
ErrConstructingRestHelperCode 11041 Alert
ErrCreatingServiceCode 11042 Alert
ErrUnmarshalCode 11043 Alert Unmarshal unknown error: %s Invalid object format Make sure to input a valid JSON object
ErrUnmarshalInvalidCode 11044 Alert Unmarshal invalid error for type: Invalid object format Make sure to input a valid JSON object
ErrUnmarshalSyntaxCode 11045 Alert Unmarshal syntax error at offest: Invalid object format Make sure to input a valid JSON object
ErrUnmarshalTypeCode 11046 Alert Unmarshal type error at key: %s. Error: %s Invalid object format Make sure to input a valid JSON object
ErrUnmarshalUnsupportedTypeCode 11047 Alert Unmarshal unsupported type error at key: Invalid object format Make sure to input a valid JSON object
ErrUnmarshalUnsupportedValueCode 11048 Alert Unmarshal unsupported value error at key: Invalid object format Make sure to input a valid JSON object
ErrMarshalCode 11049 Alert Marshal error, Description: %s Invalid object format Make sure to input a valid JSON object
ErrGetBoolCode 11050 Alert Error while getting Boolean value for key: %s, error: %s Not a valid boolean Make sure it is a boolean
ErrInvalidProtocolCode 11051 Alert invalid protocol: only http, https and file are valid protocols Network protocol is incorrect Make sure to specify the right network protocol
ErrRemoteFileNotFoundCode 11052 Alert remote file not found at File doesnt exist in the location File name is incorrect Make sure to input the right file name and location
ErrReadingRemoteFileCode 11053 Alert error reading remote file File doesnt exist in the location File name is incorrect Make sure to input the right file name and location
ErrReadingLocalFileCode 11054 Alert error reading local file File doesnt exist in the location File name is incorrect Make sure to input the right file name and location
ErrEmptyConfigCode 11055 Alert Config not initialized Viper is crashing Make sure viper is configured properly
ErrViperCode 11056 Fatal Viper configuration initialization failed Viper is crashing Make sure viper is configured properly
ErrInMemCode 11057 Fatal InMem configuration initialization failed In memory map is crashing Make sure map is configured properly
ErrPodHasNoLabelsCode 11058 Alert the pod has no labels and cannot be exposed
ErrServiceHasNoSelectorsCode 11059 Alert the service has no pod selector set
ErrInvalidDeploymentNoSelectorsLabelsCode 11060 Alert the deployment has no labels or selectors and cannot be exposed
ErrInvalidDeploymentNoSelectorsCode 11061 Alert invalid deployment: no selectors, therefore cannot be exposed
ErrInvalidReplicaNoSelectorsLabelsCode 11062 Alert the replica set has no labels or selectors and cannot be exposed
ErrInvalidReplicaSetNoSelectorsCode 11063 Alert invalid replicaset: no selectors, therefore cannot be exposed
ErrNoPortsFoundForHeadlessResourceCode 11064 Alert no ports found for the non headless resource
ErrUnknownSessionAffinityErrCode 11065 Alert unknown session affinity:
ErrMatchExpressionsConvertionErrCode 11066 Alert couldn't convert expressions - to map-based selector format
ErrFailedToExtractPodSelectorErrCode 11067 Alert cannot extract pod selector from
ErrFailedToExtractPortsCode 11068 Alert cannot extract ports from
ErrFailedToExtractProtocolsErrCode 11069 Alert cannot extract protocols from
ErrCannotExposeObjectErrCode 11070 Alert cannot expose a
ErrControllerCode 11071 Alert

Top



mesheryctl client

Error Name Error Code Severity Short Description Long Description Probable Cause Suggested Remediation
ErrHealthCheckFailedCode 1000 Alert Health checks failed
ErrInvalidAdapterCode 1001 Alert Invalid adapter specified
ErrDownloadFileCode 1002 Alert Error downloading file

Top



Meshery Adapter for linkerd

Error Name Error Code Severity Short Description Long Description Probable Cause Suggested Remediation
ErrEmptyConfigCode 1000 Alert Config is empty
ErrGetLatestReleasesCode 1001 Alert unable to fetch release info Unable to get the latest release info from the GithubAPI Checkout https://docs.github.com/en/rest/reference/repos#releases for more info
ErrGetLatestReleaseNamesCode 1002 Alert failed to extract release names Invalid release format
ErrInstallLinkerdCode 1003 Alert Error with Linkerd operation:
ErrMeshConfigCode 1004 Alert Error configuration mesh:
ErrFetchManifestCode 1005 Alert Error fetching mesh manifest: %s
ErrDownloadBinaryCode 1006 Alert Error downloading Linkerd binary: Checkout https://docs.github.com/en/rest/reference/repos#releases for more details
ErrInstallBinaryCode 1007 Alert Error installing Linkerd binary:
ErrClientConfigCode 1008 Alert Error setting client config:
ErrClientSetCode 1009 Alert Error setting clientset:
ErrSampleAppCode 1011 Alert Error with sample app operation Error occured while trying to install a sample application using manifests Invalid kubeclient config Invalid manifest Reconnect your adapter to meshery server to refresh the kubeclient
ErrCustomOperationCode 1012 Alert Error with custom operation Error occured while applying custom manifest to the cluster Invalid kubeclient config Invalid manifest Make sure to apply a valid kubernetes manifest
ErrOpInvalidCode 1013 Alert Invalid operation

Top



meshery-adapter-library library

Error Name Error Code Severity Short Description Long Description Probable Cause Suggested Remediation
ErrGetNameCode 1000
ErrCreateInstanceCode 1001
ErrMeshConfigCode 1002
ErrValidateKubeconfigCode 1003
ErrClientConfigCode 1004
ErrClientSetCode 1005
ErrStreamEventCode 1006
ErrOpInvalidCode 1007
ErrApplyOperationCode 1008
ErrListOperationsCode 1009
ErrNewSmiCode 1010
ErrRunSmiCode 1011

Top



Meshery Server

Error Name Error Code Severity Short Description Long Description Probable Cause Suggested Remediation
ErrInvalidK8SConfigCode 2000
ErrNilClientCode 2001
ErrPrometheusScanCode 2002 Alert Unable to connect to prometheus Prometheus endpoint might not be reachable from meshery Prometheus endpoint is incorrect Check if your Prometheus and Grafana Endpoint are correct Connect to Prometheus and Grafana from the settings page in the UI
ErrGrafanaScanCode 2003 Alert Unable to connect to grafana Grafana endpoint might not be reachable from meshery Grafana endpoint is incorrect Check if your Grafana Endpoint is correct Connect to Grafana from the settings page in the UI
ErrRecordPreferencesCode 2004 Alert unable to save user config data User token might be invalid db might be corrupted Relogin to Meshery
ErrGrafanaConfigCode 2005 Alert Grafana endpoint not configured Cannot find valid grafana endpoint in user pref Grafana endpoint might not be reachable from meshery Setup your Grafana Endpoint via the settings dashboard
ErrPrometheusConfigCode 2006 Alert Prometheus endpoint not configured Cannot find valid Prometheus endpoint in user pref Prometheus endpoint might not be reachable from meshery Setup your Prometheus Endpoint via the settings dashboard
ErrGrafanaQueryCode 2007 Alert Unable to query grafana Grafana query did not get executed from meshery Grafana query is invalid Check if your Grafana query is correct Connect to Grafana from the settings page in the UI
ErrPrometheusQueryCode 2008 Alert Unable to query prometheus Prometheus query did not get executed from meshery Prometheus query is invalid Check if your Prometheus query is correct Connect to Prometheus and Grafana from the settings page in the UI
ErrGrafanaBoardsCode 2009
ErrPrometheusBoardsCode 2010
ErrStaticBoardsCode 2011 Alert unable to get static board unable to get static board No boards could be available in grafana
ErrRequestBodyCode 2012
ErrMarshalCode 2013
ErrUnmarshalCode 2014
ErrEncodingCode 2015
ErrParseBoolCode 2016 Alert unable to parse : Failed due to invalid value of : please provide a valid value for :
ErrStreamEventsCode 2017 Alert There was an error connecting to the backend to get events Websocket is blocked in the network Meshery UI is not able to reach the Meshery server Ensure Meshery UI is able to reach the Meshery server
ErrStreamClientCode 2018 Alert Event streaming ended Websocket is blocked in the network Meshery UI is not able to reach the Meshery server Ensure Meshery UI is able to reach the Meshery server
ErrUnmarshalEventCode 2019
ErrPublishSmiResultsCode 2020 Alert Error publishing SMI results Meshery Cloud is not functional or reachable Make sure meshery cloud is up and reachable
ErrMarshalEventCode 2021
ErrPluginOpenCode 2022 Alert Error opening the plugin Plugin is not available in the location plugin does not match with meshery version Make sure the plugin is compatible with Meshery server
ErrPluginLookupCode 2023 Alert Error performing a plugin lookup Plugin is not available in the location Make sure the plugin is compatible with Meshery server
ErrPluginRunCode 2024 Alert Error running meshery plugin plugin does not match with meshery version Make sure the plugin is compatible with Meshery server
ErrParseFormCode 2025 Alert unable to parse form The data provided could be invalid Make sure to enter valid parameters in the form
ErrQueryGetCode 2026 Alert unable to get: Query parameter is not a part of the request Make sure to pass the query paramater in the request
ErrGetResultCode 2027 Alert unable to get result Result Identifier provided is not valid Result did not persist in the database Make sure to provide the correct identifier for the result
ErrConvertToSpecCode 2028 Alert unable to convert to spec The performance spec format is invalid Make sure to provide the correct spec
ErrFetchSMIResultsCode 2029 Alert unable to fetch SMI results SMI results did not get persisted Result identifier is invalid Make sure to provide the correct identifier for the result
ErrFormFileCode 2030 Alert error getting k8s file The kube config file does not exist in the location Make sure to upload the correct kubeconfig file
ErrReadConfigCode 2031 Alert error reading config The kubeconfig file is empty or not valid Make sure to upload the correct kubeconfig file
ErrLoadConfigCode 2032 Alert unable to load kubernetes config The kubeconfig file is empty or not valid Make sure to upload the correct kubeconfig file
ErrOpenFileCode 2033 Alert unable to open file: The file does not exist in the location Make sure to upload the correct file
ErrKubeVersionCode 2034 Alert unable to get kubernetes version Kubernetes might not be reachable from meshery Make sure meshery has connectivity to kubernetes
ErrAddAdapterCode 2035 Alert meshLocationURL is empty meshLocationURL is empty to add an adapter meshLocationURL cannot be empty to add an adapter please provide the meshLocationURL
ErrRetrieveDataCode 2036 Alert Unable to retrieve the requested data Adapter operation invalid Make sure adapter is reachable and running
ErrValidAdapterCode 2037 Alert Unable to find valid Adapter URL unable to find a valid adapter for the given adapter URL Given adapter URL is not valid Please provide a valid Adapter URL
ErrOperationIDCode 2038 Alert Error generating the operation Id Adapter operation invalid Make sure adapter is reachable and running
ErrMeshClientCode 2039 Alert Error creating a mesh client Error pinging the mesh adapter Unable to create a mesh client Unable to ping the mesh adapter Adapter could not be pinged Unable to connect to the Mesh adapter using the given config, please try again
ErrApplyChangeCode 2040 Alert Error applying the change Adapter operation invalid Make sure adapter is reachable and running
ErrRetrieveMeshDataCode 2041 Alert Error getting operations for the mesh Error getting service mesh name unable to retrieve the requested data Make sure adapter is reachable and running
ErrApplicationFailureCode 2042 Alert failed to the application
ErrDecodingCode 2043 Alert Error decoding the : Object is not a valid json object Make sure if the object passed is a valid json
ErrRetrieveUserTokenCode 2044 Alert Failed to get the user token User token could be expired Re-initiate login
ErrFailToSaveCode 2045 Alert Failed to Save: Meshery Database could be down or not reachable Restart Meshery instance and make sure database is up and reachable
ErrFailToDeleteCode 2046 Alert Failed to Delete: Meshery Database could be down or not reachable Restart Meshery instance and make sure database is up and reachable
ErrFailToLoadExtensionsCode 2047 Alert Failed to Load Extensions from Package Plugin is not available in the location plugin does not match with meshery version Make sure the plugin is compatible with Meshery server
ErrRetrievePodListCode 2055 Alert Unable to retrieve pod list Kubernetes API server might not be reachable from the Meshery server Requested resource might not be available Make sure kubernetes API server is reachable from meshery server Make sure you are requesting for a valid resource
ErrDetectServiceForDeploymentImageCode 2056 Alert Unable to detect service for deployment image Kubernetes API server might not be reachable from the Meshery server Requested resource might not be available Make sure kubernetes API server is reachable from meshery server Make sure you are requesting for a valid resource
ErrRetrieveNamespacesListCode 2057 Alert Unable to get the list of namespaces Kubernetes API server might not be reachable from the Meshery server Requested resource might not be available Make sure kubernetes API server is reachable from meshery server Make sure you are requesting for a valid resource
ErrGetNamespaceDeploymentsCode 2058 Alert Unable to get deployments in the namespace Kubernetes API server might not be reachable from the Meshery server Requested resource might not be available Make sure kubernetes API server is reachable from meshery server Make sure you are requesting for a valid resource
ErrDetectServiceWithNameCode 2059 Alert Unable to get services from the cluster with the name given in names parameter Kubernetes API server might not be reachable from the Meshery server Requested resource might not reachable from Meshery server Make sure kubernetes API server is reachable from meshery server Make sure the network connectivity is up between meshery server and the service endpoint
ErrGeneratingLoadTestCode 2060 Alert Unable to generate load test
ErrRunningTestCode 2061 Alert Unable to run test
ErrConvertingResultToMapCode 2062 Alert Unable to convert from the result to map
ErrUnmarshalCode 2063
ErrGrpcSupportCode 2064 Alert does not support gRPC load testing
ErrStartingNighthawkServerCode 2065 Alert Unable to start the nighthawk server
ErrTransformingDataCode 2066 Alert Error while transforming data
ErrRunningNighthawkServerCode 2067 Alert Error while running nighthawk server
ErrAddAndValidateExtraHeaderCode 2068 Alert Unable to add and validate extra header
ErrInClusterConfigCode 2069 Alert Unable to load in-cluster kubeconfig
ErrNewKubeClientGeneratorCode 2070 Alert Unable to generate new kube dynamic client
ErrRestConfigFromKubeConfigCode 2071 Alert Unable to create rest config from kube congif
ErrNewKubeClientCode 2072 Alert Unable to create new kube client
ErrGrafanaClientCode 2073 Alert Unable to initialize Grafana Client Unable to initializes client for interacting with an instance of Grafana server Invalid Grafana Endpoint or API-Key Update your Grafana URL and API-Key from the settings page in the UI
ErrPageSizeCode 2074 Alert Unable to prase the Page Size
ErrPageNumberCode 2075 Alert Unable to prase the Page Numer
ErrResultIDCode 2076 Alert Given resultID is not valid Given resultID is nil
ErrPerfIDCode 2077 Alert Invalid peformance profile ID
ErrMarshalCode 2078
ErrUnmarshalCode 2079
ErrGenerateUUIDCode 2080 Alert Unable to generate a new UUID
ErrLocalProviderSupportCode 2081 Alert Method not supported by local provider
ErrGrafanaOrgCode 2082 Alert Failed to get Org data from Grafana Invalid URL Invalid API-Key
ErrGrafanaBoardsCode 2083
ErrGrafanaDashboardCode 2084 Alert Error getting grafana dashboard from UID
ErrGrafanaDataSourceCode 2085 Alert Error getting Grafana Board's Datasource
ErrNilQueryCode 2086 Alert Query data passed is nil
ErrGrafanaDataCode 2087 Alert Error getting data from Grafana API
ErrApplicationFileNameCode 2088 Alert Invalid Applicationfile Name field is either not present or is not valid
ErrFilterFileNameCode 2089 Alert Invalid Filterfile Name field is either not present or is not valid
ErrPatternFileNameCode 2090 Alert Invalid Patternfile Name field is either not present or is not valid
ErrMakeDirCode 2091 Alert Unable to create directory/folder
ErrFolderStatCode 2092 Alert Unable to find (os.stat) the folder
ErrUserIDCode 2093 Alert User ID is empty
ErrDBConnectionCode 2094 Alert Connection to DataBase does not exist
ErrNilConfigDataCode 2095 Alert Given config data is nil
ErrDBOpenCode 2096 Alert Unable to open the database
ErrDBRLockCode 2097 Alert Unable to obtain read lock from bitcask store
ErrDBLockCode 2098 Alert Unable to obtain write lock from bitcask store
ErrDBReadCode 2099 Alert Unable to read data from bitcast store
ErrDBDeleteCode 2100 Alert Unable to delete config data for the user
ErrCopyCode 2101 Alert Error occurred while copying
ErrDBPutCode 2102 Alert Unable to Persist config data.
ErrPrometheusGetNodesCode 2103 Alert Prometheus Client unable to get all nodes
ErrPrometheusLabelSeriesCode 2104 Alert Unable to get the label set series
ErrPrometheusQueryRangeCode 2105 Alert Unable to fetch data for the query
ErrPrometheusStaticBoardCode 2106 Alert Unbale to get Static Boards
ErrTokenRefreshCode 2107 Alert Error occurred while Refresing the token
ErrGetTokenCode 2108 Alert Error occurred while getting token from the Browser Cookie
ErrDataReadCode 2109 Alert Eeror occurred while reading from the Reader
ErrTokenDecodeCode 2110 Alert Error occurred while Decoding Token Data
ErrNilJWKsCode 2111 Alert Invalid JWks Value of JWKs is nil
ErrNilKeysCode 2112 Alert Key not found JWK not found for the given KeyID
ErrTokenExpiredCode 2113 Alert Token has expired Token is invalid, it has expired
ErrTokenClaimsCode 2114 Alert Error occurred while prasing claims
ErrTokenClientCheckCode 2115 Alert Error occurred while performing token check HTTP request
ErrTokenPraseCode 2116 Alert Error occurred while Prasing and validating the token
ErrJWKsKeysCode 2117 Alert Unable to fetch JWKs keys from the remote provider
ErrDecodeBase64Code 2118 Alert Error occurred while decoding base65 string
ErrMarshalPKIXCode 2119 Alert Error occurred while marshaling PKIX
ErrEncodingPEMCode 2120 Alert Error occurred while encoding jwk to pem
ErrPraseUnverifiedCode 2121 Alert Error occurred while prasing tokens (unverified)
ErrEncodingCode 2122
ErrFetchCode 2123 Alert Unable to fetch data from the Provider
ErrPostCode 2124 Alert Unable to post data to the Provider
ErrDeleteCode 2125 Alert Unable to delete data from the Provider
ErrInvalidCapabilityCode 2126 Alert Capablity is not supported by your Provider You dont have access to the capability Not logged in to the vaild remote Provider Connect to the vaild remote Provider Ask the Provider Adim for access
ErrResultDataCode 2127 Alert given result data is nil
ErrUnableToPersistsResultCode 2128 Alert unable to persists the result data
ErrValidURLCode 2129 Alert Enter valid URLs
ErrTestEndpointCode 2130 Alert minimum one test endpoint needs to be specified
ErrLoadgeneratorCode 2131 Alert specify valid Loadgenerator
ErrProtocolCode 2132 Alert specify the Protocol for all clients
ErrTestClientCode 2133 Alert minimum one test client needs to be specified
ErrParsingTestCode 2134 Alert error parsing test duration, please refer to: https://docs.meshery.io/guides/mesheryctl#performance-management
ErrFieldCode 2135 Alert Error: name field is blank
ErrSaveSessionCode 2136 Alert unable to save session User session could be expired Re-initiate login
ErrDataSendCode 2137
ErrVersionCompareCode 2138 Alert failed to compare latest and current version of Meshery
ErrKubeClientCode 2139 Alert Failed to Create Kube Client Check Kubernetes Check your kubeconfig if valid Ensure meshery is able to reach the kubernetes cluster
ErrWorkloadDefinitionCode 2140 Alert Failed to load Workload Definition Workload Definition is invalid or unable to process Check Workload Definition
ErrTraitDefinitionCode 2141 Alert Failed to Encode Trait Definition Trait Definition is invalid or unable to process Check Trait Definition
ErrScopeDefinitionCode 2142 Alert Failed to Encode Scope Definition Trait Definition is invalid or unable to process Check Trait Definition
ErrPatternFileCode 2143 Alert Failed to Parse Pattern File Trait Definition is invalid or unable to process Check Trait Definition
ErrExecutionPlanCode 2144 Alert Failed to Create Execution Plan Trait Definition is invalid or unable to process Check Trait Definition
ErrInvalidPatternCode 2145 Alert Invalid Pattern, execution is infeasible Trait Definition is invalid or unable to process Check Trait Definition
ErrCompConfigPairsCode 2146
ErrFetchDataCode 2147 Alert unable to fetch result data
ErrIndexOutOfRangeCode 2148 Alert Error: index out of range
ErrSessionCopyCode 2149 Alert Error: session copy error

Top