hashicorp/nomad · error

node plugin returned an internal error, check the plugin…

Error message

node plugin returned an internal error, check the plugin allocation logs for more information: %v

What it means

In the CSI client's NodeStageVolume gRPC wrapper, the plugin returned an error with an internal/unknown status code. The raw error is wrapped with guidance to inspect the node plugin's allocation logs, since Nomad cannot classify it further.

Solutions

  1. Inspect the CSI plugin allocation logs for the underlying failure
  2. Fix the plugin-side condition (storage backend unreachable, bad config) and let staging retry
Defensive patterns

Strategy: retry

When it happens

Trigger: Thrown at plugins/csi/client.go:817 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of hashicorp/nomad@482b49bf1a (2026-09-04). Data as JSON: /api/errors/4e6cd33357d4169a. Report an issue: GitHub.

Appendix: source

Thrown at plugins/csi/client.go:817

	}

	// NodeStageVolume's response contains no extra data. If err == nil, we were
	// successful.
	_, err = c.nodeClient.NodeStageVolume(ctx, req.ToCSIRepresentation(), opts...)
	if err != nil {
		code := status.Code(err)
		switch code {
		case codes.NotFound:
			err = fmt.Errorf("volume %q could not be found: %v", req.ExternalID, err)
		case codes.AlreadyExists:
			err = fmt.Errorf(
				"volume %q is already staged to %q but with incompatible capabilities for this request: %v",
				req.ExternalID, req.StagingTargetPath, err)
		case codes.FailedPrecondition:
			err = fmt.Errorf("volume %q does not have MULTI_NODE volume capability: %v",
				req.ExternalID, err)
		case codes.Internal:
			err = fmt.Errorf("node plugin returned an internal error, check the plugin allocation logs for more information: %v", err)
		}
	}

	return err
}

func (c *client) NodeUnstageVolume(ctx context.Context, volumeID string, stagingTargetPath string, opts ...grpc.CallOption) error {
	if err := c.ensureConnected(ctx); err != nil {
		return err
	}
	// These errors should not be returned during production use but exist as aids
	// during Nomad development
	if volumeID == "" {
		return fmt.Errorf("missing volumeID")
	}
	if stagingTargetPath == "" {
		return fmt.Errorf("missing stagingTargetPath")
	}

View on GitHub (pinned to 482b49bf1a)