Skip to main content
Version: 2.15.0

通过HEI(HTTP Event Ingestion)端口使用HTTP导入数据

新建HEI端口接收数据​

  1. 进入数据导入页面，将鼠标移到左侧"数据导入"图标数据管理图标，选择“通过HTTP采集数据”。
note

此页面需要'HTTP数据采集'访问权限，具体的内容参考权限管理

hei_part1

  1. 点击带加号的"新建HEI"按钮，创建新的HEI endpoint。输入必要的配置信息 create_hei

    1. HEI端口的名称
    2. “数据源类型”是该HEI端口默认的数据源类型名称，在导入数据时，也可以用另外的数据源类型来重载这个参数。
    3. “数据集范围”是指该HEI允许导入的数据集范围，不能选取此范围以外的其他数据集来导入数据。
    4. “数据集”是该HEI端口默认的数据集名称，在导入数据时，可以用另外的数据集来重载这个参数，不过也只能从上述的数据集范围中选择一个有效的数据集。

  2. 创建HEI端口成功之后，每个端口会有一个唯一标识，使用该唯一标识可以通过API将数据写入炎凰数据平台 hei_list

  3. 点击下图中红色框中的按钮，开始创建HEI端口的API令牌。 create_hei_token

  4. 输入令牌的生命周期时间。点击颁发令牌，即可生成令牌。 create_hei_token_done

  5. 复制令牌内容，后续可以用于放入HTTP请求的header当中，将数据发送到炎凰数据平台。

note

令牌的生命周期意味着在此有效期内，可以用颁发的令牌来通过HEI的校验，超过有效期，则会导入失败。当令牌失效后，可以重新点击颁发令牌，生成一个新的可用令牌。

使用HTTP将数据发送给炎凰数据平台​

在生成HEI令牌之后，就可以通过发送HTTP POST请求的方式将数据发送给炎凰数据平台。

炎凰数据平台 HEI 的 API 调用方式

  1. API服务的url: <server_url>/api/data/v1.0/data/ingestions/events?endpoint={{endpointName}}&event_set={{eventSetName}}&_datatype={{datatype}}&_host={{host}}&_source={{source}}
  2. HTTP方法: POST
  3. 参数：
    1. endpoint: HEI端口的名称。
    2. event_set: 数据集名称，可选参数，如果不填，则使用HEI端口中设置的默认值。
    3. _datatype: 数据源类型名称，可选参数，如果不填，则使用HEI端口中设置的默认值。
    4. _host: 数据生成的主机名信息，可选参数，如果不填，则为空字符串。
    5. _source: 数据生成的数据源信息，可选参数，如果不填，则为空字符串。
  4. HTTP HEADER: 必须将http header设置成如下的内容
    1. Content-Type: text/plain
    2. Authorization: Bearer <api_token>，其中api_token是通过上一步颁发令牌得到的令牌的内容。
  5. HTTP body：POST请求的内容是要发送的数据，每一行是一条事件。

样例：使用curl发送数据到炎凰数据平台的 HEI 端口。

curl -X POST -H "Content-Type: text/plain" -H "Authorization: Bearer eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJvcmcueWFuaHVhbmcuYXVyb3JhIiwiaWF0IjoxNjAxNzgxMzUxLCJleHAiOjE2MDI2NDUzNTEsInRlbmFudCI6Inlhbmh1YW5nIiwidG9rZW4iOiI1ZDZhYmJhZC1jZDYwLTQ4MjMtYmEwZi1kNDJlOGU3ODljYjAifQ.h5K5yJZdXHv2x2jMgqglgbblhbn6UI8zUs3o9Ne9eEnIQbO3Ag05an1ye7P1AlrprvDWUQTQG-Z15LpXYlMwPek4Xv2kofCpJIeSDgRl7ueVyQqEgIWA_w_UEnqVI2IM2ugdY7lHOJNZ1LM54YOKlPqQmDTz3IUn8rRX31PvMKZlQy8EiUaemaACOVlPK3CU_GMIKcyuLlxFqsrN7xcZYEV74ThqxJXn8O7jG4Ye-_F6UvNW2x3Z5zMlX9MnriuOfveG27rLjMIXDnSREeMNh2pPnUJktrCU00YICl427pyY8-tCneLYevO5vnqQ-olzBUvZSG7s6eRidtbbcuLISQ" "http://yhp-test/api/data/v1.0/data/ingestions/events?endpoint=test-hec&event_set=main&_datatype=text&_host=bigwhite-mbp&_source=curl" --data-binary @- << EOF
this is the first line
this is the second line
this is the third line
EOF
  • 参数endpoint是创建HEI端口时候输入的端口名称

分配HEI权限​

  1. 点击HEI操作栏的"编辑权限"按钮 action_edit_permission

  2. 进入编辑权限对话框，可以编辑HEI的查看、编辑、管理权限，在复选框中选中，表示对给这个角色赋予对应的权限。 选择完之后，点击确定按钮，保存配置。 action_edit_permission