# Debugging

In order to debug the services we deploy you should understand the environment they are deployed on.

This guide will allow you to debug one of our running services in the [dogfood](../instances.md#k8s.sgdev.org) deployment which mimics our customer environment. All of our services here run on a Kubernetes cluster.

- [Debugging](#debugging)
  - [Gain-access-to-the-cluster](./tutorial.md#gain-access-to-the-cluster)
- [Tutorial](tutorial.md)

## Intro to crictl

_[Kubernetes Docs](https://kubernetes.io/docs/tasks/debug-application-cluster/crictl/)_

When debugging pods on the node itself you should prefer `crictl` from <https://github.com/kubernetes-sigs/cri-tools/releases> over docker.
This tool works with all OCI container runtime. Kubernetes supports several container runtime and docker is not the only one.


<section class="h0Wrapper headingWrapper"><section class="h1Wrapper headingWrapper"><h1 id="debugging"><a class="anchor" aria-hidden tabindex="-1" href="#debugging"><span class="icon icon-link"></span></a>Debugging</h1>
<p>In order to debug the services we deploy you should understand the environment they are deployed on.</p>
<p>This guide will allow you to debug one of our running services in the <a href="../instances#k8s.sgdev.org">dogfood</a> deployment which mimics our customer environment. All of our services here run on a Kubernetes cluster.</p>
<ul>
<li><a href="#debugging">Debugging</a>
<ul>
<li><a href="./tutorial#gain-access-to-the-cluster">Gain-access-to-the-cluster</a></li>
</ul>
</li>
<li><a href="tutorial">Tutorial</a></li>
</ul>
<section class="h2Wrapper headingWrapper"><h2 id="intro-to-crictl"><a class="anchor" aria-hidden tabindex="-1" href="#intro-to-crictl"><span class="icon icon-link"></span></a>Intro to crictl</h2>
<p><em><a href="https://kubernetes.io/docs/tasks/debug-application-cluster/crictl/">Kubernetes Docs</a></em></p>
<p>When debugging pods on the node itself you should prefer <code>crictl</code> from <a href="https://github.com/kubernetes-sigs/cri-tools/releases">https://github.com/kubernetes-sigs/cri-tools/releases</a> over docker.
This tool works with all OCI container runtime. Kubernetes supports several container runtime and docker is not the only one.</p></section></section></section>