func ConnectToRecorder(ctxcontext.Context, recs []netip.AddrPort, dialnetx.DialFunc) (io.WriteCloser, []*tailcfg.SSHRecordingAttempt, <-chanerror,error)

func SendEvent(apnetip.AddrPort, eventio.Reader, dialnetx.DialFunc) (retErrerror)

type CastHeader struct {// Version is the asciinema file format version.Versionint `json:"version"`// Width is the terminal width in characters.// It is non-zero for Pty sessions.Widthint `json:"width"`// Height is the terminal height in characters.// It is non-zero for Pty sessions.Heightint `json:"height"`// Timestamp is the unix timestamp of when the recording started.Timestampint64 `json:"timestamp"`// Command is the command that was executed.// Typically empty for shell sessions.Commandstring `json:"command,omitempty"`// SrcNode is the FQDN of the node originating the connection.// It is also the MagicDNS name for the node.// It does not have a trailing dot.// e.g. "host.tail-scale.ts.net"SrcNodestring `json:"srcNode"`// SrcNodeID is the node ID of the node originating the connection.SrcNodeIDtailcfg.StableNodeID `json:"srcNodeID"`// Tailscale-specific fields:// SrcNodeTags is the list of tags on the node originating the connection (if any).SrcNodeTags []string `json:"srcNodeTags,omitempty"`// SrcNodeUserID is the user ID of the node originating the connection (if not tagged).SrcNodeUserIDtailcfg.UserID `json:"srcNodeUserID,omitempty"`// if not tagged// SrcNodeUser is the LoginName of the node originating the connection (if not tagged).SrcNodeUserstring `json:"srcNodeUser,omitempty"`// Env is the environment variables of the session.// Only "TERM" is set (2023-03-22).Env map[string]string `json:"env"`// SSHUser is the username as presented by the client.SSHUserstring `json:"sshUser"`// as presented by the client// LocalUser is the effective username on the server.LocalUserstring `json:"localUser"`// ConnectionID uniquely identifies a connection made to the SSH server.// It may be shared across multiple sessions over the same connection in// case of SSH multiplexing.ConnectionIDstring `json:"connectionID"`// Fields that are only set for Kubernetes API server proxy session recordings:Kubernetes *Kubernetes `json:"kubernetes,omitempty"`}

type Destination struct {// Node is the FQDN of the node receiving the connection.// It is also the MagicDNS name for the node.// It does not have a trailing dot.// e.g. "host.tail-scale.ts.net"Nodestring `json:"node"`// NodeID is the node ID of the node receiving the connection.NodeIDtailcfg.StableNodeID `json:"nodeID"`}

type Event struct {// Type specifies the kind of event being recorded (e.g., "kubernetes-api-request").Typestring `json:"type"`// ID is a reference of the path that this event is stored at in tsrecorderIDstring `json:"id"`// Timestamp is the time when the event was recorded represented as a unix timestamp.Timestampint64 `json:"timestamp"`// UserAgent is the UerAgent specified in the request, which helps identify// the client software that initiated the request.UserAgentstring `json:"userAgent"`// Request holds details of the HTTP request.RequestRequest `json:"request"`// Kubernetes contains Kubernetes-specific information about the request (if// the type is `kubernetes-api-request`)KubernetesKubernetesRequestInfo `json:"kubernetes"`// Source provides details about the client that initiated the request.SourceSource `json:"source"`// Destination provides details about the node receiving the request.DestinationDestination `json:"destination"`}

type EventAPINotSupportedErr struct {// contains filtered or unexported fields}

func (EventAPINotSupportedErr)Error¶added inv1.90.0

func (eEventAPINotSupportedErr) Error()string

type Kubernetes struct {// PodName is the name of the Pod the session was recorded for.PodNamestring// Namespace is the namespace in which the Pod the session was recorded for exists in.Namespacestring// Container is the container the session was recorded for.Containerstring// SessionType is the type of session that was executed (e.g., exec, attach)SessionTypestring}

type KubernetesRequestInfo struct {// IsResourceRequest indicates whether or not the request is for an API resource or subresourceIsResourceRequestbool// Path is the URL path of the requestPathstring// Verb is the kube verb associated with the request for API requests, not the http verb.  This includes things like list and watch.// for non-resource requests, this is the lowercase http verbVerbstringAPIPrefixstringAPIGroupstringAPIVersionstringNamespacestring// Resource is the name of the resource being requested.  This is not the kind.  For example: podsResourcestring// Subresource is the name of the subresource being requested.  This is a different resource, scoped to the parent resource, but it may have a different kind.// For instance, /pods has the resource "pods" and the kind "Pod", while /pods/foo/status has the resource "pods", the sub resource "status", and the kind "Pod"// (because status operates on pods). The binding resource for a pod though may be /pods/foo/binding, which has resource "pods", subresource "binding", and kind "Binding".Subresourcestring// Name is empty for some verbs, but if the request directly indicates a name (not in body content) then this field is filled in.Namestring// Parts are the path parts for the request, always starting with /{resource}/{name}Parts []string// FieldSelector contains the unparsed field selector from a request.  It is only present if the apiserver// honors field selectors for the verb this request is associated with.FieldSelectorstring// LabelSelector contains the unparsed field selector from a request.  It is only present if the apiserver// honors field selectors for the verb this request is associated with.LabelSelectorstring}

type Request struct {Methodstring     `json:"method"`Pathstring     `json:"path"`Body            []byte     `json:"body"`QueryParametersurl.Values `json:"queryParameters"`}

type Source struct {// Node is the FQDN of the node originating the connection.// It is also the MagicDNS name for the node.// It does not have a trailing dot.// e.g. "host.tail-scale.ts.net"Nodestring `json:"node"`// NodeID is the node ID of the node originating the connection.NodeIDtailcfg.StableNodeID `json:"nodeID"`// Tailscale-specific fields:// NodeTags is the list of tags on the node originating the connection (if any).NodeTags []string `json:"nodeTags,omitempty"`// NodeUserID is the user ID of the node originating the connection (if not tagged).NodeUserIDtailcfg.UserID `json:"nodeUserID,omitempty"`// if not tagged// NodeUser is the LoginName of the node originating the connection (if not tagged).NodeUserstring `json:"nodeUser,omitempty"`}