# Skywalking

### 项目地址

{% embed url="<https://github.com/apache/skywalking>" %}

### 官方网站

{% embed url="<https://skywalking.apache.org/>" %}

### 快速上手

#### 部署skywalking

环境准备：

* k8s(配置默认storageclass)
* helm

1、安装skywalking

```
export REPO=skywalking
export SKYWALKING_RELEASE_NAME=skywalking
export SKYWALKING_RELEASE_NAMESPACE=skywalking

kubectl create ns ${SKYWALKING_RELEASE_NAMESPACE}
helm upgrade "${SKYWALKING_RELEASE_NAME}" ${REPO}/skywalking -n "${SKYWALKING_RELEASE_NAMESPACE}" --install
```

2、配置 skywalking-ui 与 skywalking-oap（如果需要从外部接入）服务 nodeport

```
apiVersion: v1
kind: Service
metadata:
  name: skywalking-ui-out
  namespace: skywalking
spec:
  ports:
  - port: 80
    protocol: TCP
    targetPort: 8080
    nodePort: 31000
  selector:
    app: skywalking
    component: ui
    release: skywalking
  sessionAffinity: None
  type: NodePort
```

```yaml
apiVersion: v1
kind: Service
metadata:
  name: skywalking-oap-out
  namespace: skywalking
spec:
  ports:
  - name: grpc
    port: 11800
    protocol: TCP
    targetPort: 11800
    nodePort: 31001
  selector:
    app: skywalking
    component: oap
    release: skywalking
  sessionAffinity: None
  type: NodePort
```

3、可通过`http://<ip>:31000`端口访问skywalking控制台，外部服务链路数据上报可通过`http://<ip>:31001`

#### 部署skywalking-swck

1、下载 skywalking operator 源码

```bash
wget https://github.com/apache/skywalking-swck/archive/refs/tags/v0.6.1.tar.gz
tar zxvf v0.6.1.tar.gz && cd v0.6.1
```

2、编译构建 skywalking operator 并推送到代码仓库

<pre class="language-bash"><code class="lang-bash"># 安装 operator 代码生成工具
go install sigs.k8s.io/controller-tools/cmd/controller-gen@v0.7.0
# 编译镜像
<strong>make -C operator docker-build
</strong><strong>
</strong><strong># 推送镜像至私有仓库
</strong>export OPERATOR_IMG=&#x3C;私有仓库地址>/skywalking/controller:v0.6.1
docker tag controller:latest ${OPERATOR_IMG}
docker push ${OPERATOR_IMG}
</code></pre>

3、部署 skywalking operator 并创建crds

```bash
# 部署 operator
make -C operator deploy

# 部署 crds 资源
make -C operator install
```

#### Java端接入

1、为目标容器组所在的命名空间添加标签，表示该命名空间可以使用 skywalking sidecar 自动注入

```
kubectl label ns <目标命名空间> swck-injection=enabled
```

2、为待注入的容器组资源添加注解配置

```
...
metadata:
  annotations:
    # 设置 java agent 镜像名
    sidecar.skywalking.apache.org/initcontainer.Image: "docker.io/apache/skywalking-java-agent:8.8.0-java8"
  labels:
    # 设置启用 java agent 注入
    swck-java-agent-injected: "true"
spec:
  ...
  containers:
  - ...
    env:
    - name: SW_AGENT_COLLECTOR_BACKEND_SERVICES
      value: skywalking-oap.skywalking:11800
    - name: SW_AGENT_NAME
      value: <当前容器组服务注册名称>
  ...
...
```

3、访问 skywalking-ui 控制台，从普通服务中可查询到已注册的服务

#### Golang 端接入

当前 golang 仅支持通过代码集成方式接入 skywalking，其中 go-gin 框架已实现了中间件层的适配，代码接入过程如下：

{% embed url="<https://golang-2.gitbook.io/handbook/avanced/lian-lu-zhui-zong/skywalking>" %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://viva.gitbook.io/project/cloud-native/skywalking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.